# 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
    ```