Whalebird-desktop-client-ma.../README.md

95 lines
2.8 KiB
Markdown
Raw Normal View History

# Whalebird
2018-03-26 14:12:57 +02:00
[![GitHub release](http://img.shields.io/github/release/h3poteto/whalebird-desktop.svg?style=flat-square)](https://github.com/h3poteto/whalebird-desktop/releases)
2018-03-07 14:28:48 +01:00
2018-03-22 17:06:49 +01:00
Whalebird is a mastodon client for desktop application. If you want to use release build, please download from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
2018-03-07 14:28:48 +01:00
2018-04-16 16:31:39 +02:00
![demo](screenshot.gif)
2018-03-23 16:05:24 +01:00
2018-03-22 17:06:49 +01:00
## Feature
2018-03-23 16:26:51 +01:00
- An interface like slack
2018-03-22 17:06:49 +01:00
- Notify to desktop
- Streaming
- Many keyboard shortcuts
- Manage multiple accounts
2018-03-23 16:14:42 +01:00
### Shortcuts
<table>
<thead>
<tr><th></th><th>Mac</th><th>Linux, Windows</th></tr>
2018-03-23 16:14:42 +01:00
</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>
2018-03-22 17:06:49 +01:00
## Install
### Mac
2018-03-27 07:08:11 +02:00
You can download `.dmg` from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
2018-03-22 17:06:49 +01:00
Please wait for distribute in Mac app store, I'm preparing.
### Linux
2018-03-27 07:08:11 +02:00
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.
2018-03-22 17:06:49 +01:00
### Windows
2018-04-15 12:46:46 +02:00
You can download `.exe` from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
2018-03-22 17:06:49 +01:00
## Development
2018-03-07 14:28:48 +01:00
``` bash
2018-03-22 17:06:49 +01:00
# clone this repository
$ git clone https://github.com/h3poteto/whalebird-desktop.git
$ cd whalebird-desktop
2018-03-07 14:28:48 +01:00
# install dependencies
2018-03-22 17:06:49 +01:00
$ npm install
2018-03-07 14:28:48 +01:00
# serve with hot reload at localhost:9080
2018-03-22 17:06:49 +01:00
$ npm run dev
```
2018-03-07 14:28:48 +01:00
2018-03-22 17:06:49 +01:00
## Release
### Binary
When you build release packages, please use `electron-builder`.
2018-03-07 14:28:48 +01:00
2018-03-22 17:06:49 +01:00
```bash
# for linux
$ npm run build:linux
2018-03-07 14:28:48 +01:00
2018-03-22 17:06:49 +01:00
# for mac
# This command automatically loads the Developer ID Application certificate from your keychain.
$ npm run build:mac
2018-03-07 14:28:48 +01:00
```
### 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`.
2018-03-22 17:06:49 +01:00
# License
The software is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).