sqr-xcursor/README.md
2025-05-30 17:55:38 +02:00

64 lines
1.6 KiB
Markdown

# sqr-xcursor
a simple, complete, 32x32, square shaped x11 cursor theme.
## Preview
![preview image](./preview.png)
## Usage
to build and install the cursor theme, `xcursorgen` is required.
you can then use the provided shell scripts:
1. create the cursor files from the png images:
```sh
# hotspot at pixel 15,15 (center), 50ms per animation frame
cd src && ./generate.sh 15 15 50
```
2. create links for some other cursors for completeness:
```sh
cd src && ./create-links.sh
```
3. install the theme
- either system-wide:
```sh
sudo mkdir -p /usr/share/icons/sqr-xcursor && sudo cp cursors $_ -r
```
- or just for the current user:
```sh
mkdir -p $XDG_DATA_HOME/icons/sqr-xcursor && cp cursors $_ -r
```
4. use the theme:
in regular desktop environments, selecting it in your settings should suffice.
without a desktop environment, setting a `default` in the `icons` directory
(whether system-wide or user-specific)
should work:
```sh
# system-wide:
sudo mkdir -p /usr/share/icons/default && \
sudo printf "\n[Icon Theme]\nInherits=sqr-xcursor\n" >> $_/index.theme
# or user-only:
mkdir -p $XDG_DATA_HOME/icons/default && \
printf "\n[Icon Theme]\nInherits=sqr-xcursor\n" >> $_/index.theme
```
### **you will need to restart your xsession after this (log out and back in)**
if issues still arise, setting the cursor theme in your `.config/gtk-3.0/settings.ini`
might also be required/help:
```ini
[Settings]
gtk-cursor-theme-name=sqr-xcursor
gtk-cursor-theme-size=32
```