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

128 lines
5.5 KiB
Markdown
Raw Normal View History

# Whalebird
2023-03-02 17:06:23 +01:00
[![Build](https://github.com/h3poteto/whalebird-desktop/actions/workflows/build.yml/badge.svg)](https://github.com/h3poteto/whalebird-desktop/actions/workflows/build.yml)
[![GitHub release](http://img.shields.io/github/release/h3poteto/whalebird-desktop.svg)](https://github.com/h3poteto/whalebird-desktop/releases)
2023-03-08 12:49:33 +01:00
[![Mac App Store](https://img.shields.io/itunes/v/6445864587)](https://apps.apple.com/us/app/whalebird/id6445864587)
2020-07-16 17:08:29 +02:00
[![AUR version](https://img.shields.io/aur/version/whalebird)](https://aur.archlinux.org/packages/whalebird/)
2019-11-19 14:59:24 +01:00
[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-blue.svg)](https://dependabot.com)
2023-03-02 17:06:23 +01:00
[![Crowdin](https://badges.crowdin.net/whalebird/localized.svg)](https://crowdin.com/project/whalebird)
2018-03-07 14:28:48 +01:00
2023-03-08 16:35:14 +01:00
Whalebird is a Fediverse client app for desktop.
2018-03-07 14:28:48 +01:00
2023-03-08 16:24:01 +01:00
![demo](screenshot.png)
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
2023-03-08 16:34:17 +01:00
- Supporting
- Mastodon
- Pleroma
- Misskey
2018-03-22 17:06:49 +01:00
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> Reload current timeline </td><td> <kbd>Cmd + r</kbd> </td><td> <kbd>Ctrl + r</kbd> </td></tr>
2023-03-08 16:26:50 +01:00
<tr><td> Select next post </td><td> <kbd>j</kbd> </td><td> <kbd>j</kbd> </td></tr>
<tr><td> Select previous post </td><td> <kbd>k</kbd> </td><td> <kbd>k</kbd> </td></tr>
<tr><td> Reply to the post </td><td> <kbd>r</kbd> </td><td> <kbd>r</kbd> </td></tr>
<tr><td> Reblog the post </td><td> <kbd>b</kbd> </td><td> <kbd>b</kbd> </td></tr>
<tr><td> Favourite the post </td><td> <kbd>f</kbd> </td><td> <kbd>f</kbd> </td></tr>
<tr><td> Open details of the post </td><td> <kbd>o</kbd> </td><td> <kbd>o</kbd> </td></tr>
<tr><td> Open account profile of the post</td><td> <kbd>p</kbd> </td><td> <kbd>p</kbd> </td></tr>
2018-08-28 01:34:27 +02:00
<tr><td> Open the images </td><td> <kbd>i</kbd> </td><td> <kbd>i</kbd> </td></tr>
<tr><td> Show/hide CW and NSFW </td><td> <kbd>x</kbd> </td><td> <kbd>x</kbd> </td></tr>
<tr><td> Close current page </td><td> <kbd>esc</kbd> </td><td> <kbd>esc</kbd> </td></tr>
<tr><td> Show shortcut keys </td><td> <kbd>?</kbd> </td><td> <kbd>?</kbd> </td></tr>
2018-03-23 16:14:42 +01:00
</tbody>
</table>
2018-03-22 17:06:49 +01:00
## Install
### Mac
[![App Store](app-store.svg)](https://itunes.apple.com/us/app/whalebird/id1378283354)
2018-05-15 02:08:37 +02:00
Or you can download `.dmg` from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
2018-03-22 17:06:49 +01:00
2018-08-15 08:38:17 +02:00
So on, you can install from Homebrew:
```
$ brew update
$ brew install --cask whalebird
2018-08-15 08:38:17 +02:00
```
:sparkles: Thanks to [@singingwolfboy](https://github.com/singingwolfboy) for adding it to [homebrew-cask](https://github.com/Homebrew/homebrew-cask/blob/cf568882b6e012956ca404a16be2db36ca873002/Casks/whalebird.rb).
2018-08-15 08:38:17 +02:00
2018-03-22 17:06:49 +01:00
### Linux
There are some packages in [release page](https://github.com/h3poteto/whalebird-desktop/releases), for example `.deb`, `.rpm` and `.AppImage`.
2018-09-13 05:09:16 +02:00
If you do not want to use the package manager, please download `.tar.bz2` file and decompress it.
2018-03-22 17:06:49 +01:00
If you are using snap, please install from [snapcraft.io](https://snapcraft.io/whalebird).
```
$ sudo snap install whalebird
```
2018-05-15 02:08:37 +02:00
2020-07-16 16:56:35 +02:00
Or you can install from [Arch User Repository](https://aur.archlinux.org/packages/whalebird/).
```
2020-07-16 16:56:35 +02:00
$ yay -S whalebird
```
2023-03-08 16:18:11 +01:00
2018-03-22 17:06:49 +01:00
### Windows
2023-03-08 16:18:11 +01:00
<a href="https://apps.microsoft.com/store/detail/whalebird/9NBW4CSDV5HC"><img src="./windows-store.svg" alt= "Windows Store" width="156" height="auto"></a>
We prepared winget package and `.exe` [files](https://github.com/h3poteto/whalebird-desktop/releases), **but we don't recommend these ways**.
Because these binary is not code signed, so you will get warnings when you launch. Only Windows Store version is signed, so please use it.
2018-03-22 17:06:49 +01:00
2023-03-08 16:18:11 +01:00
```
2023-03-08 16:26:50 +01:00
$ winget show "Whalebird" --versions
2023-03-08 16:18:11 +01:00
```
2018-03-22 17:06:49 +01:00
## Translation
If you can speak multiple languages, could you please help with translation in [Crowdin](https://crowdin.com/project/whalebird)?
Or if you want add new language, please create an issue. I will add it.
2018-03-22 17:06:49 +01:00
## Development
2018-03-07 14:28:48 +01:00
2018-08-16 10:29:43 +02:00
We'd love you to contribute to Whalebird.
### Minimum requirements for development
2022-01-27 14:44:38 +01:00
* Node.js greater than or equal version 15.0.0 (16.x is recommended)
* npm or yarn
### Getting started
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-09-26 15:01:03 +02:00
# Install font config
$ sudo apt-get install libfontconfig-dev
2018-03-07 14:28:48 +01:00
# install dependencies
2020-09-13 09:19:33 +02:00
$ yarn install
2018-03-07 14:28:48 +01:00
# serve with hot reload at localhost:9080
2020-09-13 09:19:33 +02:00
$ yarn run dev
2018-03-22 17:06:49 +01:00
```
2018-03-07 14:28:48 +01:00
2018-08-24 18:17:55 +02:00
# License
The software is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).