{"id":21111352,"url":"https://github.com/crgimenes/neko","last_synced_at":"2025-05-15T20:07:29.462Z","repository":{"id":57647169,"uuid":"407919887","full_name":"crgimenes/neko","owner":"crgimenes","description":"Neko is a cross-platform cursor-chasing cat. This is the reimplementation write in Go.","archived":false,"fork":false,"pushed_at":"2025-04-01T14:39:00.000Z","size":3494,"stargazers_count":450,"open_issues_count":16,"forks_count":43,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-08T06:36:35.574Z","etag":null,"topics":["cat","ebitengine","go","golang","neko","retro"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crgimenes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2021-09-18T17:06:06.000Z","updated_at":"2025-04-07T22:16:30.000Z","dependencies_parsed_at":"2023-02-19T07:45:50.133Z","dependency_job_id":"520c8342-72f9-4174-8f96-20b6ecbed4cf","html_url":"https://github.com/crgimenes/neko","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crgimenes%2Fneko","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crgimenes%2Fneko/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crgimenes%2Fneko/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crgimenes%2Fneko/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crgimenes","download_url":"https://codeload.github.com/crgimenes/neko/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254414499,"owners_count":22067272,"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":["cat","ebitengine","go","golang","neko","retro"],"created_at":"2024-11-20T01:02:15.527Z","updated_at":"2025-05-15T20:07:24.424Z","avatar_url":"https://github.com/crgimenes.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neko\n\n![Neko](https://raw.githubusercontent.com/crgimenes/neko/master/assets/awake.png)\n\n[Neko](https://en.wikipedia.org/wiki/Neko_(software)) is a cat that chases the mouse cursor across the screen, an app written in the late 1980s and ported for many platforms.\n\n![Neco](https://github.com/crgimenes/neko/blob/master/fixtures/neko.gif)\n\nThis code is a re-implementation using Golang and **has no relationship to the original software**. Furthermore, this version does not use any part of the original source code except sprites and sounds.\n\nThe goal is to demonstrate the Go language with a fun and very nostalgic example, without necessarily being tied to the behavior of the original version.\n\nIn this example, we used the [Ebitengine](https://ebitengine.org), an incredibly easy-to-use gaming library with a vibrant community.\n\n## How to run\n\nNote that some operating systems may restrict the execution of binaries downloaded from the internet for security reasons. Please consult your operating system documentation to learn how to enable Neko to run.\n\n```bash\nexport CGO_ENABLED=1\ngo run main.go\n```\n\nOr you can build the binary and run it:\n\n```bash\nexport CGO_ENABLED=1\ngo build -o neko main.go\n```\nParameters\n\n- `-mousepassthrough` Enable mouse passthrough (default false).\n- `-quiet` Disable sound.\n- `-scale` The scale of the cat on the screen (default 2.0).\n- `-speed` The speed of the cat (default 2).\n- `-h` Show help.\n\n## How to install\n\nBefore installing Neko, make sure you have Go installed on your system, as we will be using `go install`.\n\nInstall dependencies, build, and install the project into your Go bin directory:\n\n```bash\ncd neko\ngo mod tidy\ngo install\n```\n\nTo use Neko globally across your system, check if your Go bin directory is in your `$PATH` by running:\n\n```bash\necho $PATH\n```\nIf you don't see a Go bin directory, you'll need to add the following line to your `~/.bashrc`, `~/.zshrc`, or the equivalent shell configuration file:\n\n```bash\nexport PATH=$PATH:$(go env GOPATH)/bin\n```\n\nAfter that, you can simply run `neko` in your terminal. If you want it to start with your system, you can add it to your `.xinitrc` or a similar startup script.\n\n## How to Contribute\n\nPlease follow our [contribution guide](CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrgimenes%2Fneko","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrgimenes%2Fneko","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrgimenes%2Fneko/lists"}