{"id":13613045,"url":"https://github.com/spencerwooo/PaimonMenuBar","last_synced_at":"2025-04-13T15:32:27.275Z","repository":{"id":40432849,"uuid":"473184265","full_name":"spencerwooo/PaimonMenuBar","owner":"spencerwooo","description":"Track real-time Genshin Impact stats in your macOS menubar","archived":true,"fork":false,"pushed_at":"2023-03-11T01:19:24.000Z","size":18465,"stargazers_count":162,"open_issues_count":2,"forks_count":12,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-07T21:41:43.730Z","etag":null,"topics":["genshin","genshin-impact","genshinimpact","macos","menubar","menubar-app","paimon"],"latest_commit_sha":null,"homepage":"https://paimon.swo.moe","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spencerwooo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2022-03-23T12:46:03.000Z","updated_at":"2024-08-12T06:16:02.000Z","dependencies_parsed_at":"2024-01-17T00:18:34.698Z","dependency_job_id":"4bf88d08-f0ae-450d-ae72-3b692956afbb","html_url":"https://github.com/spencerwooo/PaimonMenuBar","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spencerwooo%2FPaimonMenuBar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spencerwooo%2FPaimonMenuBar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spencerwooo%2FPaimonMenuBar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spencerwooo%2FPaimonMenuBar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spencerwooo","download_url":"https://codeload.github.com/spencerwooo/PaimonMenuBar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248735890,"owners_count":21153496,"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":["genshin","genshin-impact","genshinimpact","macos","menubar","menubar-app","paimon"],"created_at":"2024-08-01T20:00:38.449Z","updated_at":"2025-04-13T15:32:26.801Z","avatar_url":"https://github.com/spencerwooo.png","language":"Swift","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Assets/logo.png\" alt=\"logo\" width=\"160\" height=\"160\" /\u003e\n  \u003ch3\u003e\u003ccode\u003ePaimonMenuBar\u003c/code\u003e\u003c/h3\u003e\n  \u003cp\u003e\u003cem\u003eTrack real-time Genshin Impact stats in your macOS menubar\u003c/em\u003e\u003c/p\u003e\n\n  \u003cimg src=\"https://img.shields.io/badge/uses-SwiftUI-f05138?labelColor=282c34\u0026logo=swift\" alt=\"Use Swift\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/macOS-11.0+-f05138?labelColor=282c34\u0026logo=apple\" alt=\"macOS 11.0+\" /\u003e\n  \u003ca href=\"https://github.com/spencerwooo/PaimonMenuBar/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/spencerwooo/PaimonMenuBar?labelColor=282c34\u0026logo=GitHub\" alt=\"GitHub Release\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n## What's this?\n\n![screenshot](Assets/screenshot.jpg)\n\n\u003e Paimon helps you track your Genshin Impact daily resin, expeditions, and more — straight in your macOS menu bar.\n\nPaimon can help you —\n\n* 🌙 Keep track of your daily resin.\n* 💰 Monitor your daily expeditions and real-time realm currency.\n* 🏁 Remind you about your daily commissions and weekly boss fights.\n* 🍯 And notify you when your parametric transformer is ready to use.\n\nBasically, `PaimonMenuBar` lives in your macOS menu bar quietly, and offers you a nice way of monitoring your in-game real-time stats when you need to check them.\n\n\u003e **Note**\n\u003e\n\u003e `PaimonMenuBar` is made with SwiftUI, designed for and native to macOS.\n\n## Download\n\n[![GitHub Release](https://img.shields.io/github/v/release/spencerwooo/PaimonMenuBar?labelColor=282c34\u0026logo=GitHub\u0026style=for-the-badge)](https://github.com/spencerwooo/PaimonMenuBar/releases/latest)\n\n## Things to know\n\n1. Paimon uses the official Hoyoverse API found in either [米游社 (for CN players)](https://bbs.mihoyo.com/ys/) or [HoYoLAB (for Global players)](https://www.hoyolab.com/home).\n2. Yes, Paimon needs your cookie. It is so that Paimon can request said API on your behalf, and fetch those in-game stats periodically. Rest assured that **the cookie is only stored locally.**\n3. Check [FAQ](https://paimon.swo.moe/) if you have anymore questions.\n\n## Credits\n\n* Credits to [@Chawong](https://www.pixiv.net/en/artworks/92415888) for the logo. (Love from Hu Tao :heart:)\n* iOS widget (Scriptable): [[闲聊杂谈][工具分享] iOS 快捷指令/小组件](https://bbs.nga.cn/read.php?tid=29801567)\n* Friendly browser extension alternative: [daidr/paimon-webext](https://github.com/daidr/paimon-webext)\n* Friendly Windows alternative: [ArvinZJC/PaimonTray](https://github.com/ArvinZJC/PaimonTray)\n\n\u003cdetails\u003e\n\u003csummary\u003eDevelopment notes.\u003c/summary\u003e\n\n## TO-DO\n\n* [x] Menu bar of varying height.\n* [x] Configurable data refresh rate.\n* [x] Start at login.\n* [x] `i18n` support for at least Simplified Chinese and English.\n* [x] Manual refresh button.\n* [x] Code-sign and publish as `.dmg`.\n* [x] Auto-updates and check for update.\n* [x] Custom website and help for acquiring the cookie.\n* [x] Help button beside the text field for entering the cookie.\n* [x] Support for cn and global genshin accounts (米游社 and hoyolab).\n* [x] Backward-compatibility for macOS 11.0.\n* [x] Better first-time installation experience (guidance for initial setup).\n* ~~[ ] Support for multiple accounts?~~\n\n## Releasing a new version\n\n* Create a build in Xcode, bump the build number, and notarize build.\n* Create a new release on GitHub with a new version tag and increment the build number.\n* Use `create-dmg` to create the `.dmg` file:\n\n  ```bash\n  create-dmg PaimonMenuBar.app\n  ```\n\n* Update appcast.xml with the new version tag and build number:\n\n  ```bash\n  cd \u003cPATH_TO_SPARKLE\u003e/artifacts/sparkle/bin\n  ./generate_appcast \u003cPATH_TO_PROJECT\u003e/PaimonMenuBar/Build/\n  ```\n\n* Profit.\n\n\u003c/details\u003e\n\n## License\n\n[MIT](LICENSE)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Assets/footer.png\" /\u003e\n  \u003cem\u003emade with ❤️ by \u003ca href=\"https://spencerwoo.com\"\u003espencer woo\u003c/a\u003e\u003c/em\u003e\n\u003c/div\u003e\n","funding_links":[],"categories":["Swift","Entertainment"],"sub_categories":["Games"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspencerwooo%2FPaimonMenuBar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspencerwooo%2FPaimonMenuBar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspencerwooo%2FPaimonMenuBar/lists"}