https://github.com/keiaa-75/cc.py
Convert Windows cursors to Linux-compatible formats.
https://github.com/keiaa-75/cc.py
cursor cursor-theme cursors linux linux-desktop
Last synced: 4 months ago
JSON representation
Convert Windows cursors to Linux-compatible formats.
- Host: GitHub
- URL: https://github.com/keiaa-75/cc.py
- Owner: keiaa-75
- License: cc0-1.0
- Created: 2025-08-05T10:24:07.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-08-06T02:06:01.000Z (5 months ago)
- Last Synced: 2025-09-04T06:34:06.872Z (4 months ago)
- Topics: cursor, cursor-theme, cursors, linux, linux-desktop
- Language: Python
- Homepage: https://github.com/nozomi-75/cc.py/releases
- Size: 140 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cc.py
**cc.py** is a user-friendly GUI tool designed to convert Windows cursor themes (`.cur` and `.ani` files) into a format compatible with Linux desktop environments.
The application uses the `win2xcur` command-line utility and provides a graphical interface for managing the entire conversion process, including dependency setup, file mapping, and theme installation.
This project started out with `safeusernameig`, when they inquired our forum about converting Project Sekai cursors for use in Linux Mint. It started out as a simple bash script but has since then been reconsidered to be built as a modular Python application using PyQt6.
## Features
- **GUI interface:** A clean and intuitive graphical user interface built with PyQt6.
- **Dependency management:** Automatically sets up a Python venv and installs the necessary deps.
- **Customizable cursor mapping:** The asset mapping is now moved to a JSON key-pair value system.
- **Theme generation:** Automatically creates the required `cursor.theme` and `index.theme` files for the new cursor theme.
- **Optional post-conversation actions:** Provides options to automatically zip the theme folder and install it to the `~/.icons` directory.
- **Detailed status log:** Provides real-time feedback on the conversion process in a dedicated status log.
## Prerequisites
To run this application, you need to have the following installed on your Linux system:
- **Python 3:** The application is built with Python 3.
- `pip` and `venv`: This is used to manage Python packages and create a virtual environment. These are often included with your Python installation. On some systems, you may need to install the `python3*-venv` package.
- `zip`: This is the command-line utility used for zipping files. It is typically included with your Linux distribution.
## A little note
I am a Java developer primarily and is currently learning Python. So, this project was developed with Google's Gemini, which served as a coding partner throughout the process. If you have any questions or suggestions about the program, please feel free to reach out.