{"id":13512431,"url":"https://github.com/Cosmo/Clippy","last_synced_at":"2025-03-30T22:32:44.765Z","repository":{"id":49352126,"uuid":"206281376","full_name":"Cosmo/Clippy","owner":"Cosmo","description":"📎💬🎉 Clippy from Microsoft Office is back and runs on macOS! Written in Swift.","archived":false,"fork":false,"pushed_at":"2019-09-29T16:14:51.000Z","size":9511,"stargazers_count":753,"open_issues_count":6,"forks_count":30,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-03-29T06:04:04.194Z","etag":null,"topics":["clippy","hacktoberfest","macos","spritekit","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cosmo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-09-04T09:23:20.000Z","updated_at":"2025-03-23T01:39:12.000Z","dependencies_parsed_at":"2022-09-23T23:00:54.190Z","dependency_job_id":null,"html_url":"https://github.com/Cosmo/Clippy","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo%2FClippy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo%2FClippy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo%2FClippy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo%2FClippy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cosmo","download_url":"https://codeload.github.com/Cosmo/Clippy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246390878,"owners_count":20769476,"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":["clippy","hacktoberfest","macos","spritekit","swift"],"created_at":"2024-08-01T03:01:51.454Z","updated_at":"2025-03-30T22:32:44.745Z","avatar_url":"https://github.com/Cosmo.png","language":"Swift","readme":"# Clippy\n\nYes, Clippy from Microsoft Office is back — on macOS!\n\n---\n\nClippy can be moved around (drag with mouse) and be animated (right-click).\n\nThe `SpriteKit`-Framework is used to animate through Clippy's sprite map.\n\n--- \n\n## First start\n\n1. [Download Clippy for macOS](https://github.com/Cosmo/Clippy/releases/download/2.0.0/Clippy.zip) or build from source.\n2. Run\n3. Click `📎` → `Show in Finder` in the menu bar\n4. Unzip all files\n5. Click `📎` → `Reload`\n6. Pick an Agent under `📎` → `Agents` → `…`\n\n\n## Todos\n\n* [x] Animations (Right-Click → Animate! or press the Space bar)\n* [x] Always on top\n* [x] Sounds\n  * [x] Mute / Unmute\n* [x] Transparent when out of focus\n* [x] Support for other agents\n* [x] Agent picker \n* [x] Menu bar Item\n* [ ] Original size / Zoom\n* [ ] Actions\n  * [x] Hide\n  * [x] Show\n  * [ ] MoveTo x y\n  * [ ] GestureAt x y\n  * [x] Play animation\n* [ ] Clean up\n  * [ ] Rewrite the ugly parts (many references and force unwraps)\n  * [ ] Extract the Agent reader into its own libary\n  * [ ] Test!\n* [ ] HitTest on transparent regions\n* [ ] Support branching and probability\n* [ ] Idle animations\n* [ ] Languages\n* [ ] Control via command line\n\n## Demo\n\n![Demo](https://github.com/Cosmo/Clippy/blob/master/Clippy.gif?raw=true)\n\n\n## Build\n\n```sh\ngit clone https://github.com/Cosmo/Clippy.git\n```\n\n* Open project with Xcode\n* Build and run the macOS target\n\n\n## Add other Agents (optional)\n\nAn `*.acs` file includes all required resources (bitmaps, sounds, definitions, etc.) of an agent.\nUnfortunately, this project does not support `*.acs` files, yet. But hopefully in the future — pull-requests are welcome.\n \nUntil then, you can convert `*.acs` files with the \"[MSAgent Decompiler](http://www.lebeausoftware.org/software/decompile.aspx)\" by  Lebeau Software.\nThis software extracts all resources that we need, from an `*.acs`.\nThere are a few steps involved.\n\n### Requirements\n\n```\nbrew install imagemagick\n```\nWill be used to merge single `*.bmp` sprites into a single 32 bit PNG-file. \n\n\n```\nbrew install ffmpeg\n```\nWill be used to convert `*.wav`-files in RIFF format to MP3 files.\n\n### Conversion\n\nIncluded in this project is a converter called `agent-converter.sh`.\nThis tool takes opaque BMP sprites, removes background colors, puts them together to one big transparent PNG file and converts all sounds to MP3. \n\n`./agent-convert.sh PATH_TO_AGENT NEW_NAME`\n\n`AGENT_PATH` path to decompiled agent directory.\n`NEW_NAME` should only include lowercase letters.\n\n#### Example\n\n`./agent-convert agents/CLIPPIT clippy`\n\n### Final step\n\nAfter the conversion step, you will get a new folder called `NEW_NAME.agent`.\n\n1. Click `📎` → `Show in Finder` in the menu bar.\n2. Move it to the Agents directory.\n3. Click `📎` → `Reload`\n4. Select new Agent under `📎` → `Agents` → `…`\n\n## Attributions\n\nInspiration was taken from:\n\n* https://github.com/tanathos/ClippyVS (C#)\n* https://github.com/smore-inc/clippy.js (JavaScript)\n\nGraphics were created by *Microsoft*.\n\n## Clippy: The Unauthorized Biography\n\nWatch the Unauthorized Biography with [Steven Sinofsky](https://twitter.com/stevesi), if you're interested in Clippy's history!\n\n[![Clippy: The Unauthorized Biography](https://img.youtube.com/vi/8bhjNvSSuLM/0.jpg)](https://www.youtube.com/watch?v=8bhjNvSSuLM)\n\n## Contact\n\n* Devran \"Cosmo\" Uenal\n* Twitter: [@maccosmo](http://twitter.com/maccosmo)\n","funding_links":[],"categories":["Swift"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCosmo%2FClippy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCosmo%2FClippy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCosmo%2FClippy/lists"}