Skip to content

README.md

Latest commit

 

History

History
121 lines (88 loc) · 4.6 KB

README.md

File metadata and controls

121 lines (88 loc) · 4.6 KB

currust - a cursor converter

Release crates.io

A tool written in Rust to convert cursors between Windows and Linux. Specifically, converting from the CUR/ANI format to the Xcursor format (plus some other features).

Installation

There are currently two supported methods of installation:

  • download the binaries on the releases page (recommended)
  • build from crates with cargo install currust (requires cargo)

Usage

The intended use-case of this tool is to convert a Windows cursor theme to Linux. A cursor theme is a directory that contains some cursors, along with an installer file that uses the INF format.

You can convert a cursor theme as such:

currust ./my-cursor-theme

This converts the theme and writes the produced X11 theme (which is a directory) in the current directory. Add the --out (or -o for short) argument to place it in the specified path.

currust ./my-cursor-theme -o ./please/go/here/instead

Cursor themes on Windows can be scaled by Windows itself. Unfortunately, this feature doesn't exist on most Linux distributions, so Xcursor themes have to include their own size variations.

The --scale-to argument is available to provide some scale factors, along with --scale-with to provide a scaling algorithm to use (default: Lanczos3).

Note that this increases the size of the resulting cursor theme.

Tip

For pixel art cursors, use nearest-neighbour scaling with --scale-with nearest. Integer scale factors work best.

currust ./my-cursor-theme --scale-to 1.5 2 3 --scale-with mitchell

Afterwards, move the converted theme to the system-wide /usr/share/icons or the local ~/.icons (recommended). Anything listed here should work. Switching to this cursor theme depends on your distribution (or more so, your DE), so just (kindly) look it up.

For more information on other commands and possible usages, view the help text:

currust -h      # Summarised help text
currust --help  # Detailed help text
Example usage 
❯ tree  # Expected cursor theme layout (as input)
.
└── [The Herta Cursor ver.2.0.0]
    ├── 01-Normal.ani
    ├── 02-Link.ani
    ├── 03-Loading.ani
    ├── 04-Help.ani
    ├── 05-Text Select Alt.ani
    ├── 05-Text Select.ani
    ├── 06-Handwriting.ani
    ├── 07-Precision.ani
    ├── 08-Unavailable.ani
    ├── 09-Location Select.ani
    ├── 10-Person Select.ani
    ├── 11-Vertical Resize.ani
    ├── 12-Horizontal Resize.ani
    ├── 13-Diagonal Resize 1.ani
    ├── 14-Diagonal Resize 2.ani
    ├── 15-Move.ani
    ├── 16-Alternate Select.ani
    ├── [Changelog].txt
    └── Installer.inf

2 directories, 19 files

❯ currust \[The\ Herta\ Cursor\ ver.2.0.0\] --scale-to 5 --scale-with nearest -o ~/.icons

❯ plasma-apply-cursortheme ~/.icons/The\ Herta\ Cursor\ ver\ 2.0.0 # If you're on KDE
Successfully applied the mouse cursor theme The Herta Cursor ver 2.0.0 to your current Plasma session

This creates a cursor theme upscaled to 5x using nearest-neighbour scaling. The original 1x scale is still included. This may be useful for larger screens, or for my use case, making the enlarged cursor from KDE's shake cursor effect not look blurry (since the cursor theme is pixel-art).

About Windows

If you're using Windows, you can still use this. For symlink coverage, a bash script will be generated for users to run instead.

Goals

All the baseline goals I had for this project are complete, so this is closer to a "planned/future features" section. Note that not everything here may be added.

  • Publish or otherwise for usage with cargo and package managers
  • Replace bash script generation by exporting to tar.gz
  • Conversion from X11 cursors to Windows cursors (i.e, the other way around)
  • SVG cursor themes for KDE Plasma
  • hyprcursor (cursor format for hyprland) support ➜ covered by hyprcursor-util
  • Have a guided installation process for themes with no installer file

The name ("currust") comes from a portmanteau of "cursor" and "Rust".