CursorPort is a modern, web-based tool designed to bridge the gap between Windows and Linux customization. It allows users to easily convert and map Windows animated cursor schemes (.ani) into compliant Linux X11/Wayland cursor themes.
- Universal Linux Support: Works on Arch, Ubuntu, Fedora, Debian, and more.
- Desktop Environment Friendly: Generates specific configuration commands for GNOME, KDE Plasma, and XFCE.
- Visual Mapping: Intuitive interface to map Windows cursor roles (e.g., "Working in Background") to Linux equivalents (e.g.,
left_ptr_watch). - One-Click Script Generation: Instantly generates a shell script (
install_cursors.sh) to handle symbolic linking and installation. - Themed UI: Features a beautiful, responsive UI with "Miku" (Dark) and "Teto" (Light) themes, complete with transition animations.
- Persistent Settings: Automatically saves your paths, mappings, and preferences so you never lose your work.
No installation required! Just visit the website to start converting your cursors.
- Open the Tool: Visit the link above.
- Configure: Enter your settings and map your Windows
.anifiles. - Generate: Download the generated shell script.
- Run: Execute the script on your Linux machine to apply the cursors.
While the UI runs in the browser, the underlying conversion relies on the win2xcur tool.
1. Install win2xcur:
- Arch Linux (AUR):
yay -S win2xcur
- Universal (Pip):
pip install win2xcur
2. Follow the Deployment Pipeline: Use the tool to generate your installation script, then follow the on-screen instructions to run it in your terminal.
- Dark Mode Muse: Hatsune Miku V4X (Illustration by iXima)
- Light Mode Muse: Kasane Teto SV (Illustration by Sakauchi Waka)
- Transition Engine: Akita Neru (Design by Smith Hioka)
This project is open-source. Feel free to modify and distribute.

