lncur 1.1.0

CLI tool to automate symlinking files when porting Windows cursors to Linux

Lncur

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

Install

Pypi

pip install lncur

Aur

lncur is also available on the AUR with your AUR helper.

yay -S python-lncur

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

You can run lncur -m to quickly set up the directory

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/Xcursor 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:

usage: lncur [-h] [-v] [-l] [-m MAKE]

options:
  -h, --help       show this help message and exit
  -v, --version    Prints version
  -l, --link       Symlinks cursors files
  -m, --make MAKE  Make a cursor theme directory

Dev

1. Install uv
2. Run:

git clone https://github.com/claymorwan/lncur.git
cd lncur
uv venv
source ./.venv/bin/activate
uv sync

3. Build package with uv build