{"id":18274563,"url":"https://github.com/ful1e5/notwaita-cursor","last_synced_at":"2025-08-18T22:31:27.242Z","repository":{"id":242373310,"uuid":"805358632","full_name":"ful1e5/notwaita-cursor","owner":"ful1e5","description":" A cursor theme inspired by the Adwaita icons from the GNOME Project for Windows and Linux with HiDPI support. (@ful1e5 fork)","archived":false,"fork":false,"pushed_at":"2024-06-11T13:14:03.000Z","size":405,"stargazers_count":72,"open_issues_count":3,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-12-13T21:32:29.058Z","etag":null,"topics":["cursor-theme","free","gnome-shell","linux-cursor-themes","popular","windows-cursors"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ful1e5.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"ful1e5"}},"created_at":"2024-05-24T12:07:44.000Z","updated_at":"2024-12-12T18:17:52.000Z","dependencies_parsed_at":"2024-06-11T13:31:13.116Z","dependency_job_id":"267da302-e38c-44c9-912a-56f966869e29","html_url":"https://github.com/ful1e5/notwaita-cursor","commit_stats":null,"previous_names":["ful1e5/notwaita-cursor-theme"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2Fnotwaita-cursor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2Fnotwaita-cursor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2Fnotwaita-cursor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2Fnotwaita-cursor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ful1e5","download_url":"https://codeload.github.com/ful1e5/notwaita-cursor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230284070,"owners_count":18202330,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cursor-theme","free","gnome-shell","linux-cursor-themes","popular","windows-cursors"],"created_at":"2024-11-05T12:09:59.258Z","updated_at":"2024-12-18T14:14:09.852Z","avatar_url":"https://github.com/ful1e5.png","language":"Shell","funding_links":["https://github.com/sponsors/ful1e5"],"categories":[],"sub_categories":[],"readme":"# Notwaita Cursor Theme\n\nA cursor theme inspired by the Adwaita icons from the GNOME Project for `Windows` and `Linux` with _HiDPI_ support. Original work by [donut2/notwaita-cursor-theme](https://gitlab.com/donut2/notwaita-cursor-theme).\n\n[![build](https://github.com/ful1e5/notwaita-cursor/actions/workflows/build.yml/badge.svg)](https://github.com/ful1e5/notwaita-cursor/actions/workflows/build.yml)\n\n## Notes\n\n-   All cursor's SVG files are found in [svg](./svg) directory or you can also find them on [Figma](https://www.figma.com/design/pytcdZCnx9NwL6Ao6jFQmb/nowaita?node-id=0-1\u0026t=aeAWgQMBcGylCJyj-1).\n\n\u003c!-- If you're interested, you can learn more about \"sponsor-spotlight\" on\n https://dev.to/ful1e5/lets-give-recognition-to-those-supporting-our-work-on-github-sponsors-b00 --\u003e\n\n![shoutout-sponsors](https://sponsor-spotlight.vercel.app/sponsor?login=ful1e5)\n\n---\n\n![Notwaita Black](https://github.com/ful1e5/notwaita-cursor/assets/24286590/335b3cff-def6-484b-bf2f-140b3b38e346)\n![Notwaita Gray](https://github.com/ful1e5/notwaita-cursor/assets/24286590/196cbf29-e8bb-4c51-ac18-74cadb6ac8b9)\n![Notwaita White](https://github.com/ful1e5/notwaita-cursor/assets/24286590/59573dae-070b-4639-a735-5e9144ef2d13)\n\n## Cursor Sizes\n\n### Xcursor Sizes:\n\n\u003ckbd\u003e16\u003c/kbd\u003e\n\u003ckbd\u003e20\u003c/kbd\u003e\n\u003ckbd\u003e22\u003c/kbd\u003e\n\u003ckbd\u003e24\u003c/kbd\u003e\n\u003ckbd\u003e28\u003c/kbd\u003e\n\u003ckbd\u003e32\u003c/kbd\u003e\n\u003ckbd\u003e40\u003c/kbd\u003e\n\u003ckbd\u003e48\u003c/kbd\u003e\n\u003ckbd\u003e56\u003c/kbd\u003e\n\u003ckbd\u003e64\u003c/kbd\u003e\n\u003ckbd\u003e72\u003c/kbd\u003e\n\u003ckbd\u003e80\u003c/kbd\u003e\n\u003ckbd\u003e88\u003c/kbd\u003e\n\u003ckbd\u003e96\u003c/kbd\u003e\n\n### Windows Cursor Size:\n\n| size | Regular (× ²⁄₃) | Large (× ⁴⁄₅) | Extra-Large (× 1) |\n| ---: | --------------: | ------------: | ----------------: |\n|   32 |     21.333 → 22 |     25.6 → 26 |                32 |\n|   48 |              32 |     38.4 → 39 |                48 |\n|   64 |     42.666 → 43 |     51.2 → 52 |                64 |\n|   96 |              64 |     76.8 → 77 |                96 |\n|  128 |     85.333 → 86 |   102.4 → 103 |               128 |\n|  256 |   170.666 → 171 |   204.8 → 205 |               256 |\n\n## Colors\n\n### Black\n\n-   Base Color - `#000000` (Black)\n-   Outline Color - `#FFFFFF` (White)\n\n### White\n\n-   Base Color - `#FFFFFF` (White)\n-   Outline Color - `#000000` (Black)\n\n### Gray\n\n-   Base Color - `#404040` (Gray)\n-   Outline Color - `#000000` (Black)\n\n## How to get it\n\nYou can download latest `stable` \u0026 `development` releases from\n[Release Page](https://github.com/ful1e5/notwaita-cursor/releases).\n\n## Installing Notwaita Cursor\n\n#### Linux/X11\n\n**Installation:**\n\n```bash\ntar -xvf Notwaita-Black.tar.gz                 # extract `.tar.gz`\nmv Notwaita-* ~/.icons/                        # Install to local users\nsudo mv Notwaita-* /usr/share/icons/           # Install to all users\n```\n\n**Uninstallation:**\n\n```bash\nrm ~/.icons/Notwaita-*                         # Remove from local users\nsudo rm /usr/share/icons/Notwaita-*            # Remove from all users\n```\n\n#### Windows\n\n**Installation:**\n\n1. Unzip `.zip` file\n2. Open unziped directory in Explorer, and **right click** on `install.inf`.\n3. Click 'Install' from the context menu, and authorize the modifications to your system.\n4. Open Control Panel \u003e Personalization and Appearance \u003e Change mouse pointers,\n   and select **Notwaita Cursors**.\n5. Click '**Apply**'.\n\n**Uninstallation:**\n\nRun the `uninstall.bat` script packed with the `.zip` archive\n\n**OR** follow these steps:\n\n1. Go to **Registry Editor** by typing the same in the _start search box_.\n2. Expand `HKEY_CURRENT_USER` folder and expand `Control Panel` folder.\n3. Go to `Cursors` folder and click on `Schemes` folder - all the available custom cursors that are\n   installed will be listed here.\n4. **Right Click** on the name of cursor file you want to uninstall; for eg.: _Notwaita Cursors_ and\n   click `Delete`.\n5. Click '**yes**' when prompted.\n\n## Build From Source\n\n### Prerequisites\n\n-   Python version 3.7 or higher\n-   [clickgen](https://github.com/ful1e5/clickgen)\u003e=2.2.5 (`pip install clickgen`)\n-   [yarn](https://github.com/yarnpkg/yarn)\n\n### Quick start\n\n1. Install [build prerequisites](#prerequisites) on your system\n2. `git clone https://github.com/ful1e5/notwaita-cursor`\n3. `cd notwaita-cursor`\n4. `yarn install`\n5. `yarn generate`\n6. See [Installing Notwaita Cursor](#installing-notwaita-cursor).\n\n### Getting Started\n\nOnce you have the [build prerequisites](#prerequisites) installed, You can personalize colors,\ncustomize sizes, change target platforms, and more. This process involves using external tools,\nas this repository only contains SVG files and configuration for these tools:\n\n-   [cbmp](https://github.com/ful1e5/cbmp): Used for customizing colors and generating PNG files.\n-   [ctgen](https://github.com/ful1e5/clickgen): Used for customizing sizes and building XCursor and Windows Cursors.\n\nYou can refer to the README of each tool for more information on their command-line options.\n\n#### Crafting Your Notwaita Cursor\n\nThe process of creating custom cursor themes involves two main steps:\n\n1. Rendering SVG files to PNG files.\n2. Building cursor themes from PNG files.\n\n#### Customize Colors\n\n`cbmp` provides three options for changing colors:\n\n1. `-bc`: Base color, which replaces the `#00FF00` color in the SVG.\n2. `-oc`: Outlined color, which replaces the `#0000FF` color in the SVG.\n3. `-wc` (optional): Watch Background color, which replaces the `#FF0000` color in the SVG.\n\n```bash\nnpx cbmp [...] -bc '\u003chex\u003e' -oc '\u003chex\u003e' -wc '\u003chex\u003e'\n```\n\nAlternatively, you can provide a JSON configuration file to render SVG files, which contains a sequence of `cbmp` commands:\n\n```bash\nnpx cbmp render.json\n```\n\n#### Customize Sizes\n\n##### Customize Windows Cursor size\n\nTo build Windows cursor with size `16`:\n\n```bash\nctgen build.toml -s 16 -p windows -d \"bitmaps/Notwaita-Black\" -n \"Notwaita-Black\" -c \"Notwaita Black Cursors with size 16\"\n```\n\nYou can also customize output directory with `-o` option:\n\n```bash\nctgen build.toml -s 16 -p windows -d \"bitmaps/Notwaita-Black\" -o \"out\" -n \"Notwaita-Black\" -c \"Notwaita Black Cursors with size 16\"\n```\n\n##### Customize XCursor size\n\nTo build XCursor with size `16`:\n\n```bash\nctgen build.toml -s 16 -p x11 -d \"bitmaps/Notwaita-Black\" -n \"Notwaita-Black\" -c \"Notwaita Black XCursors with size 16\"\n```\n\nYou can also assign multiple sizes to `ctgen` for XCursors build:\n\n```bash\nctgen build.toml -s 16 24 32 -p x11 -d \"bitmaps/Notwaita-Black\" -n \"Notwaita-Black\" -c \"Custom Sizes Notwaita Black XCursors\"\n```\n\n#### Examples\n\nLets generate Notwaita cursor with green and black colors:\n\n```bash\nnpx cbmp -d \"svg\" -o \"bitmaps/Notwaita-Hacker\" -bc \"#00FE00\" -oc \"#000000\"\n```\n\nAfter rendering custom color you have to build cursor through `ctgen`:\n\n```bash\nctgen build.toml -d \"bitmaps/Notwaita-Hacker\" -n \"Notwaita-Hacker\" -c \"Green and Black Notwaita cursors.\"\n```\n\nAfterwards, Generated theme can be found in the `themes` directory.\n\n###### Notwaita Gruvbox\n\n```bash\nnpx cbmp -d \"svg\" -o \"bitmaps/Notwaita-Gruvbox\" -bc \"#282828\" -oc \"#EBDBB2\" -wc \"#000000\"\nctgen build.toml -d \"bitmaps/Notwaita-Gruvbox\" -n \"Notwaita-Gruvbox\" -c \"Groovy Notwaita cursors.\"\n```\n\n###### Notwaita Solarized Dark\n\n```bash\nnpx cbmp -d \"svg\" -o \"bitmaps/Notwaita-Solarized-Dark\" -bc \"#002b36\" -oc \"#839496\" -wc \"#000000\"\nctgen build.toml -d \"bitmaps/Notwaita-Solarized-Dark\" -n \"Notwaita-Solarized-Dark\" -c \"Solarized Dark Notwaita cursors.\"\n```\n\n###### Notwaita Solarized Light\n\n```bash\nnpx cbmp -d \"svg\" -o \"bitmaps/Notwaita-Solarized-Light\" -bc \"#839496\" -oc \"#002b36\"\nctgen build.toml -d \"bitmaps/Notwaita-Solarized-Light\" -n \"Notwaita-Solarized-Light\" -c \"Solarized Light Notwaita cursors.\"\n```\n\n###### Notwaita Dracula\n\n```bash\nnpx cbmp -d \"svg\" -o \"bitmaas/Notwaita-Dracula\" -bc \"#282a36\" -oc \"#f8f8f2\"\nctgen build.toml -d \"bitmaps/Notwaita-Dracula\" -n \"Notwaita-Dracula\" -c \"Dracula Notwaita cursors.\"\n```\n\n## Testing Cursor\n\nThere are several websites that allow you to test your cursor states by hovering over buttons. This can be very useful when developing or verifying the behavior of a cursor. The following websites cover many of the most commonly used cursors, although they may not include all available options.\n\n-   [Cursor-Test](https://vibhorjaiswal.github.io/Cursor-Test/)\n-   [Mozilla CSS Cursor](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor)\n\nFor a blueprint for creating XCursors, you may also want to refer to [Cursor-demo](https://wiki.tcl-lang.org/page/Cursor+demo).\n\n## Credit\n\n[Notwaita Cursor Theme](https://gitlab.com/donut2/notwaita-cursor-theme) ·\n[Adwaita](https://github.com/GNOME/adwaita-icon-theme) ·\n[Dmz](https://github.com/GalliumOS/dmz-cursor-theme) ·\n[Yaru](https://github.com/ubuntu/yaru)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fful1e5%2Fnotwaita-cursor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fful1e5%2Fnotwaita-cursor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fful1e5%2Fnotwaita-cursor/lists"}