{"id":18274572,"url":"https://github.com/ful1e5/google_cursor","last_synced_at":"2025-04-07T17:07:44.814Z","repository":{"id":38011778,"uuid":"122211415","full_name":"ful1e5/Google_Cursor","owner":"ful1e5","description":"An opensource cursor theme inspired by Google.","archived":false,"fork":false,"pushed_at":"2023-12-22T04:48:57.000Z","size":4940,"stargazers_count":310,"open_issues_count":7,"forks_count":19,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-31T16:21:33.010Z","etag":null,"topics":["anicursorgen","google","hacktoberfest","opensource","windows","xcursor-theme","xcursorgen"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ful1e5.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","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":"2018-02-20T14:47:59.000Z","updated_at":"2025-03-28T17:14:31.000Z","dependencies_parsed_at":"2023-12-22T05:30:18.953Z","dependency_job_id":"bf5d1f90-281d-4e21-96ba-23232c7474fe","html_url":"https://github.com/ful1e5/Google_Cursor","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2FGoogle_Cursor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2FGoogle_Cursor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2FGoogle_Cursor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ful1e5%2FGoogle_Cursor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ful1e5","download_url":"https://codeload.github.com/ful1e5/Google_Cursor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247694875,"owners_count":20980733,"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":["anicursorgen","google","hacktoberfest","opensource","windows","xcursor-theme","xcursorgen"],"created_at":"2024-11-05T12:10:00.902Z","updated_at":"2025-04-07T17:07:44.791Z","avatar_url":"https://github.com/ful1e5.png","language":"Shell","readme":"# Google Cursor\n\nAn OpenSource cursor theme inspired by Google.\n\n[![Build](https://github.com/ful1e5/Google_Cursor/workflows/build/badge.svg)](https://github.com/ful1e5/Google_Cursor/actions?query=workflow%3Abuild)\n\n## Notes\n\n-   All cursor's SVG files are found in [svg](./svg) directory or you can also find them on\n    [Figma](https://www.figma.com/file/i7nfGDWCTWlNJlnhmvHDfh/Google-Cursor?node-id=0%3A1).\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![GoogleDot Blue](https://imgur.com/osnWiED.png)\n![GoogleDot Black](https://i.imgur.com/9ZlC1gD.png)\n![GoogleDot White](https://i.imgur.com/67KgJ3s.png)\n![GoogleDot Red](https://imgur.com/VtauWGC.png)\n\n## Cursor Sizes\n\n### Xcursor Sizes:\n\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-   \u003ckbd\u003e16x16\u003c/kbd\u003e - Small\n-   \u003ckbd\u003e24x24\u003c/kbd\u003e - Regular\n-   \u003ckbd\u003e32x32\u003c/kbd\u003e - Large\n-   \u003ckbd\u003e48x48\u003c/kbd\u003e - Extra Large\n\n## Colors:\n\n### GoogleDot Blue\n\n-   Base Color - `#4285F4` (Blue)\n-   Outline Color - `#FFFFFF` (White)\n\n### GoogleDot Black\n\n-   Base Color - `#000000` (Black)\n-   Outline Color - `#FFFFFF` (White)\n\n### GoogleDot White\n\n-   Base Color - `#FFFFFF` (Black)\n-   Outline Color - `#000000` (White)\n\n### GoogleDot Red\n\n-   Base Color - `#FF0000` (Red)\n-   Outline Color - `#FFFFFF` (White)\n\n## How to get it\n\n### Easiest Way\n\nYou can download latest `stable` \u0026 `development` releases from\n[Release Page](https://github.com/ful1e5/Google_Cursor/releases).\n\n### Packages\n\n\u003e **Note**\n\u003e If you're having trouble with the packages please submit a request to the package maintainer\n\u003e before creating an issue.\n\n#### Arch Linux/Manjaro\n\nArch Linux/Manjaro users can install from the [AUR](https://aur.archlinux.org/packages/googledot-cursor-theme)\ncurrently maintained by [_@yochananmarqos_](https://aur.archlinux.org/packages/?K=yochananmarqos\u0026SeB=m).\nCan be installed via Pamac (preinstalled in Manjaro), Paru or any other\n[AUR helper](https://wiki.archlinux.org/index.php/AUR_helpers).\n\n```bash\nparu -S googledot-cursor-theme\n```\n\n#### Nix/NixOS\n\nNix users can install from the [package in nixpkgs](https://search.nixos.org/packages?channel=unstable\u0026buckets=%7B%22package_attr_set%22%3A%5B%5D%2C%22package_license_set%22%3A%5B%5D%2C%22package_maintainers_set%22%3A%5B%22Henry%20Hiles%22%5D%2C%22package_platforms%22%3A%5B%5D%7D\u0026query=google_cursor) (Maintained by [@Henry-Hiles](https://github.com/Henry-Hiles)). Installation instructions can be found by clicking on the title of the [nix package](https://search.nixos.org/packages?channel=unstable\u0026buckets=%7B%22package_attr_set%22%3A%5B%5D%2C%22package_license_set%22%3A%5B%5D%2C%22package_maintainers_set%22%3A%5B%22Henry%20Hiles%22%5D%2C%22package_platforms%22%3A%5B%5D%7D\u0026query=google_cursor). The nix package is currently **only** available in unstable.\n\n## Installing Google Cursor\n\n#### Linux/X11\n\n**Installation:**\n\n```bash\ntar -xvf GoogleDot-Blue.tar.gz                # extract `GoogleDot-Blue.tar.gz`\nmv GoogleDot-* ~/.icons/                      # Install to local users\nsudo mv GoogleDot-* /usr/share/icons/         # Install to all users\n```\n\n**Uninstallation:**\n\n```bash\nrm ~/.icons/GoogleDot-*                       # Remove from local users\nsudo rm /usr/share/icons/GoogleDot-*          # 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 **Google 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.: _Google Cursors_ and\n   click `Delete`.\n5. Click '**yes**' when prompted.\n\n## Build From Source\n\n#### Notes\n\n-   Google Cursor build configuration and cursor hotspot settings are bundled in the `build.toml` file.\n-   Check out the scripts section in [package.json](./package.json) to see how we build the cursor theme,\n    excluding the render scripts. They are useful for converting `.svg` files to `.png` files.\n-   yarn is optional, For building XCursors and Windows cursors from `.png` files or resizing them\n    you don't need that. If you want to develop/modify Google Cursor's colors, and bitmaps, or generate a png\n    file from a svg, Then you can use yarn because bitmapper is written in TypeScript.\n-   Since Google Cursor variants are designed similarly, they share the same hotspot settings so a\n    single configuration file `build.toml` is responsible for building all variants. Due to this, you will have\n    to change the following options in `ctgen` to build the appropriate variant:\n    -   **-d**: bitmaps directory\n    -   **-n**: The name you want to give to the generated theme.\n    -   **-c**: Theme comment.\n    -   See `ctgen --help` for all available options.\n\n### Build prerequisites\n\n-   Python version 3.7 or higher\n-   [clickgen](https://github.com/ful1e5/clickgen)\u003e=2.1.2 (`pip install clickgen`)\n-   [yarn](https://github.com/yarnpkg/yarn)\n\n### Quick start\n\n1. Install [build prerequisites](#build-prerequisites) on your system\n2. `git clone https://github.com/ful1e5/Google_Cursor`\n3. `cd Google_Cursor \u0026\u0026 yarn build`\n4. See [Installing Google Cursor](#installing-google-cursor).\n\n### Building\n\n\u003e **Note**\n\u003e Bitmaps are already generated in the `bitmaps` directory and **managed by the maintainer**\n\u003e (do not edit them directly).\n\nFirst make sure you installed the [build prerequisites](#build-prerequisites).\nNow that you have the dependencies, you can try build individual themes from bitmaps and\ncustomize sizes, target platform, and etc. with the `ctgen` CLI (packed with `clickgen`).\n\n#### `yarn build` aberration\n\nHere are the default commands we used to build the Google Cursor's variants and packed them into `yarn build`:\n\n```bash\nctgen build.toml -d 'bitmaps/GoogleDot-Blue' -n 'GoogleDot-Blue' -c 'Blue cursor theme inspired on Google'\nctgen build.toml -d 'bitmaps/GoogleDot-Black' -n 'GoogleDot-Black' -c 'Black cursor theme inspired on Google'\nctgen build.toml -d 'bitmaps/GoogleDot-White' -n 'GoogleDot-White' -c 'White cursor theme inspired on Google'\nctgen build.toml -d 'bitmaps/GoogleDot-Red' -n 'GoogleDot-Red' -c 'Red cursor theme inspired on Google'\n```\n\nAfterwards, the themes can be found in the `themes` directory.\n\n#### Customize Sizes\n\n\u003e **Note**\n\u003e You can change the cursor size up to 200 because pngs are rendered with 200x200.\n\u003e If the cursor is resized by more than rendered png size, the final cursor will be blurred.\n\n##### Customize Windows Cursor size\n\nTo build Windows cursor with size `16`:\n\n\u003e **Warning**\n\u003e Windows cursor supports only one size, if multiple sizes are given with `-s` the first size will\n\u003e be considered in build.\n\n```bash\nctgen build.toml -s 16 -p windows -d 'bitmaps/GoogleDot-Blue' -n 'GoogleDot-Blue' -c 'Blue cursor theme inspired on Google 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/GoogleDot-Blue'-o 'out' -n 'GoogleDot-Blue' -c 'Blue cursor theme inspired on Google 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/GoogleDot-Blue' -n 'GoogleDot-Blue' -c 'Blue cursor theme inspired on Google 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/GoogleDot-Blue' -n 'GoogleDot-Blue' -c 'Blue cursor theme inspired on Google with size 16'\n```\n\n#### Customize Colors\n\nTo customize Google Cursor's color you have to install node dependencies with `yarn install` command.\nAfter installing dependencies you can customize the colors via `npx cbmp` Node CLI App which packed with\n[cbmp](https://github.com/ful1e5/cbmp) node package.\n\n##### `yarn render` aberration\n\nHere are the default commands we used for generating the Google Cursor's bitmaps and packed them into `yarn render`:\n\n```bash\nnpx cbmp -d 'svg' -n 'GoogleDot-Blue' -bc '#4285F4' -oc '#FFFFFF'\nnpx cbmp -d 'svg' -n 'GoogleDot-Black' -bc '#000000' -oc '#FFFFFF'\nnpx cbmp -d 'svg' -n 'GoogleDot-White' -bc '#FFFFFF' -oc '#000000'\nnpx cbmp -d 'svg' -n 'GoogleDot-Red' -bc '#FF0000' -oc '#FFFFFF'\n```\n\n#### Examples\n\nLets generate modern GoogleDot with green base color and black outline:\n\n```bash\nnpx cbmp -d 'svg' -n 'GoogleDot-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/GoogleDot-Hacker' -n 'GoogleDot-Hacker' -c 'Green and black GoogleDot cursors.'\n```\n\nAfterwards, Generated theme can be found in the `themes` directory.\n\n###### GoogleDot Gruvbox\n\n```bash\nnpx cbmp -d 'svg' -n 'GoogleDot-Gruvbox' -bc '#282828' -oc '#EBDBB2'\nctgen build.toml -d 'bitmaps/GoogleDot-Gruvbox' -n 'GoogleDot-Gruvbox' -c 'Groovy GoogleDot cursors.'\n```\n\n###### GoogleDot Solarized Dark\n\n```bash\nnpx cbmp -d 'svg' -n 'GoogleDot-Solarized-Dark' -bc '#002b36' -oc '#839496'\nctgen build.toml -d 'bitmaps/GoogleDot-Solarized-Dark' -n 'GoogleDot-Solarized-Dark' -c 'Solarized Dark GoogleDot cursors.'\n```\n\n###### GoogleDot Solarized Light\n\n```bash\nnpx cbmp -d 'svg' -n 'GoogleDot-Solarized-Light' -bc '#839496' -oc '#002b36'\nctgen build.toml -d 'bitmaps/GoogleDot-Solarized-Light' -n 'GoogleDot-Solarized-Light' -c 'Solarized Light GoogleDot cursors.'\n```\n\n###### GoogleDot Dracula\n\n```bash\nnpx cbmp -d 'svg' -n 'GoogleDot-Dracula' -bc '#282a36' -oc '#f8f8f2'\nctgen build.toml -d 'bitmaps/GoogleDot-Dracula' -n 'GoogleDot-Dracula' -c 'Dracula GoogleDot cursors.'\n```\n\n# Bugs\n\nBugs should be reported [here](https://github.com/ful1e5/Google_Cursor/issues) on the Github issues page.\n\n# Getting Help\n\nYou can create a **issue**, I will help you.\n\n# Contributing\n\nCheck [CONTRIBUTING.md](CONTRIBUTING.md), any suggestions for features and contributions to the continuing code masterelopment can be made via the issue tracker or code contributions via a `Fork` \u0026 `Pull requests`.\n","funding_links":["https://github.com/sponsors/ful1e5"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fful1e5%2Fgoogle_cursor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fful1e5%2Fgoogle_cursor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fful1e5%2Fgoogle_cursor/lists"}