lncur 1.0.3

Script to automate symlinking files when porting Windows cursors to Linux

Lncur

A simple python script to easily port Windows cursor packs to Linux!

Install

Manually

1. Get the executable by building it or downloaded from the releases.
2. Run:

mv lncur ~/.local/bin/

Don't forget to add ~/.local/bin to your $PATH !

Aur

ln is also available on the AUR with your AUR helper (in my case paru).

$ paru -S lncur

Running from file

You can also just download/copy the lncur.py file and put it directly in your working directory.

Usage

Setup

1. First you need to set up your cursor theme directory, you can refer to the step 5 of the KDE guide for creating cursor theme. It should look like this :

Root of your super cool ported theme :D
├── cursors
└── index.theme

2. Put all of your Windows cursor theme files (.ico and/or .ani) in the cursors directory.
3. Rename all your file like the following (here using default Windows cursor names, depending on what cursor theme you're porting, the files can be named different, it's fine just rename them):

Cursor	Windows name	Linux/X name
	Normal select	default
	Text select	text
	Busy	wait
	Precision select	crosshair
	Alternate select	up-arrow
	Diagonal resize 1	size_fdiag
	Diagonal resize 2	size_bdiag
	Horizontal resize	size_hor
	Vertical resize	size_ver
	Move	fleur
	Unavailable	not-allowed
	Link select	pointer
	Working in background	progress
	Help select	help
	The pen one idk the name	pencil

All of the names are taken from the KDE breeze cursor theme
Cursors image from Microsoft
You can remove the pin and person cursors as they're not used.

4. Convert the files to X cursor files using win2xcur, you can convert them all by going in the cursors directory and run

win2xcur *

Now your cursor theme should look like this now:

Root of ur super amazing theme :3
├── cursors
│   ├── crosshair
│   ├── default
│   ├── fleur
│   ├── help
│   ├── not-allowed
│   ├── pencil
│   ├── pointer
│   ├── progress
│   ├── size_bdiag
│   ├── size_fdiag
│   ├── size_hor
│   ├── size_ver
│   ├── text
│   ├── up-arrow
│   └── wait
└── index.theme

Running the program

Now you can use lncur to do all the symlinking by running lncur inside the directory where the cursors dir and running:

$ lncur -l

All arguments:

$ lncur -h
usage: lncur.py [-h] [-v] [-l]

options:
  -h, --help     show this help message and exit
  -v, --version  Prints version
  -l, --link     Symlinks cursors files

Build

1. Install pyinstaller
2. Run:

git clone https://github.com/claymorwan/lncur.git
cd lncur
pyinstaller --onefile lncur.py

3. The path to the executable will be ./dist/lncur