Skip to content

Commit

Permalink
Add REAME
Browse files Browse the repository at this point in the history
  • Loading branch information
kleqing committed Nov 28, 2022
1 parent 71b79a1 commit 56d4659
Showing 1 changed file with 32 additions and 41 deletions.
73 changes: 32 additions & 41 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
<div align="center">
<img src="Assets/logo.png" alt="logo" width="160" height="160" />
<h3><code>PaimonMenuBar</code></h3>
<p><em>Track real-time Genshin Impact stats in your macOS menubar</em></p>
<p><em>Real-time tracking your Genshin Impact account status into your macOS menubar</em></p>

<img src="https://img.shields.io/badge/uses-SwiftUI-f05138?labelColor=282c34&logo=swift" alt="Use Swift" />
<img src="https://img.shields.io/badge/macOS-11.0+-f05138?labelColor=282c34&logo=apple" alt="macOS 11.0+" />
<a href="https://github.com/spencerwooo/PaimonMenuBar/releases/latest"><img src="https://img.shields.io/github/v/release/spencerwooo/PaimonMenuBar?labelColor=282c34&logo=GitHub" alt="GitHub Release" /></a>
<img src="https://img.shields.io/badge/macOS-11.0+-f05138?labelColor=282c34&logo=apple" alt="macOS 10.13+" />
<a href="https://github.com/kleqing/HoyoBar/releases/latest"><img src="https://img.shields.io/github/v/release/spencerwooo/PaimonMenuBar?labelColor=282c34&logo=GitHub" alt="GitHub Release" /></a>
</div>

## What's this?

![screenshot](Assets/screenshot.jpg)
![screenshot](Assets/src.png)

> Paimon helps you track your Genshin Impact daily resin, expeditions, and more — straight in your macOS menu bar.
Expand All @@ -21,66 +21,55 @@ Paimon can help you —
* 🏁 Remind you about your daily commissions and weekly boss fights.
* 🍯 And notify you when your parametric transformer is ready to use.

Basically, `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.
Basically, `HoyoBar` 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.

> **Note**
>
> `PaimonMenuBar` is made with SwiftUI, designed for and native to macOS.
> `HoyoBar` is made with SwiftUI, designed for and native to macOS.
> Support both Intel (x86) and M1 (arm64)
## Download

[![GitHub Release](https://img.shields.io/github/v/release/spencerwooo/PaimonMenuBar?labelColor=282c34&logo=GitHub&style=for-the-badge)](https://github.com/spencerwooo/PaimonMenuBar/releases/latest)
[![GitHub Release](https://img.shields.io/github/v/release/kleqing/HoyoBar?labelColor=282c34&logo=GitHub&style=for-the-badge)](https://github.com/kleqing/HoyoBar/releases/latest)

## Installation

> Open `.dmg` file, copy `HoyoBar.app` to /Application
> Open `HoyoBar.app`
> https://paimon.swo.moe
## Things to know

1. 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).
2. 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.**
3. Check [FAQ](https://paimon.swo.moe/) if you have anymore questions.
1. HoyoBar 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).
2. Yes, HoyoBar needs your cookie. It is so that HoyoBar can request said API on your behalf, and fetch those in-game stats periodically. Rest assured that **the cookie is only stored locally.**

## Credits

* Credits to [@Chawong](https://www.pixiv.net/en/artworks/92415888) for the logo. (Love from Hu Tao :heart:)
* iOS widget (Scriptable): [[闲聊杂谈][工具分享] iOS 快捷指令/小组件](https://bbs.nga.cn/read.php?tid=29801567)
* Friendly browser extension alternative: [daidr/paimon-webext](https://github.com/daidr/paimon-webext)
* Friendly Windows alternative: [ArvinZJC/PaimonTray](https://github.com/ArvinZJC/PaimonTray)
* Credits to @spencerwoo for his original app. Check [here](https://github.com/spencerwooo/PaimonMenuBar) if you want to use original version instead of this one!

<details>
<summary>Development notes.</summary>

## TO-DO
## Features

* [x] Menu bar of varying height.
* [x] Configurable data refresh rate.
* [x] Start at login.
* [x] `i18n` support for at least Simplified Chinese and English.
* [x] Manual refresh button.
* [x] Complie using target 10.13 instead of 11.0+.
* [x] Supported both Intel and M1 Macs.
* [x] Support English, Chinese and Vietnamese.
* [x] Using HoyoLab icon instead of HuTao icon (I love original icon than HuTao icon although I got her at 2.2 because I want to make some people think that it's 'HoyoLab Lite')
* [x] Code-sign and publish as `.dmg`.
* [x] Auto-updates and check for update.
* [x] Auto-updates and check for update. (I didn't check yet)
* [x] Custom website and help for acquiring the cookie.
* [x] Help button beside the text field for entering the cookie.
* [x] Support for cn and global genshin accounts (米游社 and hoyolab).
* [x] Backward-compatibility for macOS 11.0.
* [x] Better first-time installation experience (guidance for initial setup).
* ~~[ ] Support for multiple accounts?~~

## Releasing a new version

* Create a build in Xcode, bump the build number, and notarize build.
* Create a new release on GitHub with a new version tag and increment the build number.
* Use `create-dmg` to create the `.dmg` file:

```bash
create-dmg PaimonMenuBar.app
```

* Update appcast.xml with the new version tag and build number:
## Build

```bash
cd <PATH_TO_SPARKLE>/artifacts/sparkle/bin
./generate_appcast <PATH_TO_PROJECT>/PaimonMenuBar/Build/
```
* Using Xcode 13, Swift 5.5 and SDK 10.13.
* App icon was built from Apple icon template for Adobe Photoshop.
* Using DropDMG to create `.dmg` file.

* Profit.
* Add appcast.xml with the version tag and build number.

</details>

Expand All @@ -90,5 +79,7 @@ Basically, `PaimonMenuBar` lives in your macOS menu bar quietly, and offers you

<div align="center">
<img src="Assets/footer.png" />
<em>made with ❤️ by <a href="https://spencerwoo.com">spencer woo</a></em>
<em>Rebuilt by <a href="https://github.com/kleqing">kleqing</a><br>All credit are belongs to <a href="https://spencerwoo.com">spencerwoo</a>.
</em>
<h6>This is a forked version and I just built for mine. For the long term support, please using the <a href="https://github.com/spencerwooo/PaimonMenuBar">original</a> one.</h6>
</div>

0 comments on commit 56d4659

Please sign in to comment.