mirror of
https://github.com/h3poteto/whalebird-desktop
synced 2024-12-12 08:46:34 +01:00
128 lines
3.4 KiB
Markdown
128 lines
3.4 KiB
Markdown
# Whalebird
|
|
[](https://github.com/h3poteto/whalebird-desktop/releases)
|
|
|
|
Whalebird is a mastodon client for desktop application. If you want to use this app, please install
|
|
|
|
Mac App Store: https://itunes.apple.com/us/app/whalebird/id1378283354
|
|
|
|
snapcraft: https://snapcraft.io/whalebird
|
|
|
|
or please download binary from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
|
|
|
|
|
|
|
|
## Feature
|
|
|
|
- An interface like slack
|
|
- Notify to desktop
|
|
- Streaming
|
|
- Many keyboard shortcuts
|
|
- Manage multiple accounts
|
|
|
|
### Shortcuts
|
|
|
|
<table>
|
|
<thead>
|
|
<tr><th></th><th>Mac</th><th>Linux, Windows</th></tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr><td> Toot, Reply </td><td> <kbd>Cmd + Enter</kbd> </td><td> <kbd>Ctrl + Enter</kbd> </td></tr>
|
|
<tr><td> Change accounts </td><td> <kbd>Cmd + 1, 2, 3...</kbd> </td><td> <kbd>Ctrl + 1, 2, 3...</kbd> </td></tr>
|
|
<tr><td> Jump to another timeline </td><td> <kbd>Cmd + k</kbd> </td><td> <kbd>Ctrl + k</kbd> </td></tr>
|
|
<tr><td> Open new toot window </td><td> <kbd>Cmd + n</kbd> </td><td> <kbd>Ctrl + n</kbd> </td></tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
## Install
|
|
### Mac
|
|
|
|
You can install the app from Mac App Store: https://itunes.apple.com/us/app/whalebird/id1378283354
|
|
|
|
Or you can download `.dmg` from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
|
|
|
|
|
|
### Linux
|
|
|
|
You can download `.deb` or `.rpm` from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
|
|
If you do not want to use package manager, please download `.tar.bz2` file and docompress it.
|
|
|
|
Or please install the app from snapcraft.io: https://snapcraft.io/whalebird
|
|
|
|
### Windows
|
|
|
|
You can download `.exe` from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
|
|
|
|
## Development
|
|
|
|
``` bash
|
|
# clone this repository
|
|
$ git clone https://github.com/h3poteto/whalebird-desktop.git
|
|
$ cd whalebird-desktop
|
|
|
|
# install dependencies
|
|
$ npm install
|
|
|
|
# serve with hot reload at localhost:9080
|
|
$ npm run dev
|
|
```
|
|
|
|
## Release
|
|
### Binary
|
|
When you build release packages, please use `electron-builder`.
|
|
|
|
```bash
|
|
# for linux
|
|
$ npm run build:linux
|
|
|
|
# for mac
|
|
# This command automatically loads the Developer ID Application certificate from your keychain.
|
|
$ npm run build:mac
|
|
```
|
|
|
|
### AppStore
|
|
|
|
Please prepare certificates on your Apple developer console. The following keys are required:
|
|
|
|
- Mac App Distribution: `3rd Party Mac Developer Application: NAME (TEAM_ID)`
|
|
- Mac Installer Distribution: `3rd Party Mac Developer Installer: NAME (TEAM_ID)`
|
|
|
|
and register your KeyChain.
|
|
|
|
Then, create a Mac App ID like `org.whalebird.desktop`.
|
|
|
|
```bash
|
|
$ npm run build:mas
|
|
|
|
# This command automatically loads the certificates from you keychain.
|
|
$ ./appStore.sh
|
|
```
|
|
|
|
After that, the `.pkg` file is created under `./packages`.
|
|
|
|
Please upload the `.pkg` to App Store using Application Loader in Xcode.
|
|
|
|
### Snapcraft
|
|
|
|
First, please prepare snapcraft command.
|
|
|
|
```bash
|
|
$ brew install snapcraft
|
|
```
|
|
|
|
And prepare docker environment which is used in snapcraft building.
|
|
|
|
Build app for linux.
|
|
|
|
```bash
|
|
$ npm run build:linux
|
|
```
|
|
|
|
And upload.
|
|
|
|
```bash
|
|
$ snapcraft push build/whalebird_1.0.0_amd64.snap --release stable
|
|
```
|
|
|
|
# License
|
|
The software is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
|