mirror of
https://github.com/h3poteto/whalebird-desktop
synced 2024-12-26 16:53:59 +01:00
Update README
This commit is contained in:
parent
8734b5f0fe
commit
82651ba9c5
118
README.md
118
README.md
@ -1,38 +1,106 @@
|
||||
<p align="center"><img src="https://i.imgur.com/a9QWW0v.png"></p>
|
||||
# Whalebird
|
||||
[![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)
|
||||
[![Mac App Store](https://img.shields.io/itunes/v/6445864587)](https://apps.apple.com/us/app/whalebird/id6445864587)
|
||||
[![AUR version](https://img.shields.io/aur/version/whalebird)](https://aur.archlinux.org/packages/whalebird/)
|
||||
[![Crowdin](https://badges.crowdin.net/whalebird/localized.svg)](https://crowdin.com/project/whalebird)
|
||||
|
||||
## Usage
|
||||
|
||||
### Create an App
|
||||
Whalebird is a Fediverse client app for desktop.
|
||||
|
||||
## Feature
|
||||
|
||||
- An interface like slack
|
||||
- Notify to desktop
|
||||
- Streaming
|
||||
- Manage multiple accounts
|
||||
- Supporting
|
||||
- Mastodon
|
||||
- Pleroma
|
||||
- Friendica
|
||||
- Firefish
|
||||
|
||||
## Install
|
||||
### Mac
|
||||
[![App Store](app-store.svg)](https://itunes.apple.com/us/app/whalebird/id1378283354)
|
||||
|
||||
Or you can download `.dmg` from [release page](https://github.com/h3poteto/whalebird-desktop/releases).
|
||||
|
||||
So on, you can install from Homebrew:
|
||||
|
||||
```
|
||||
# with npx
|
||||
$ npx create-nextron-app my-app --example with-tailwindcss
|
||||
|
||||
# with yarn
|
||||
$ yarn create nextron-app my-app --example with-tailwindcss
|
||||
|
||||
# with pnpm
|
||||
$ pnpm dlx create-nextron-app my-app --example with-tailwindcss
|
||||
$ brew update
|
||||
$ brew install --cask whalebird
|
||||
```
|
||||
|
||||
### Install Dependencies
|
||||
: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).
|
||||
|
||||
|
||||
### Linux
|
||||
There are some packages in [release page](https://github.com/h3poteto/whalebird-desktop/releases), for example `.deb`, `.rpm` and `.AppImage`.
|
||||
If you do not want to use the package manager, please download `.tar.bz2` file and decompress it.
|
||||
|
||||
If you are using snap, please install from [snapcraft.io](https://snapcraft.io/whalebird).
|
||||
|
||||
```
|
||||
$ cd my-app
|
||||
|
||||
# using yarn or npm
|
||||
$ yarn (or `npm install`)
|
||||
|
||||
# using pnpm
|
||||
$ pnpm install --shamefully-hoist
|
||||
$ sudo snap install whalebird
|
||||
```
|
||||
|
||||
### Use it
|
||||
If you are using flatpak, please install from
|
||||
[flathub.org](https://flathub.org/apps/details/social.whalebird.WhalebirdDesktop).
|
||||
|
||||
```
|
||||
# development mode
|
||||
$ yarn dev (or `npm run dev` or `pnpm run dev`)
|
||||
|
||||
# production build
|
||||
$ yarn build (or `npm run build` or `pnpm run build`)
|
||||
$ flatpak install social.whalebird.WhalebirdDesktop
|
||||
```
|
||||
|
||||
Or you can install from [Arch User Repository](https://aur.archlinux.org/packages/whalebird/).
|
||||
|
||||
```
|
||||
$ yay -S whalebird
|
||||
```
|
||||
|
||||
|
||||
### Windows
|
||||
<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.
|
||||
|
||||
```
|
||||
$ winget show "Whalebird" --versions
|
||||
```
|
||||
|
||||
## 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.
|
||||
|
||||
## Development
|
||||
|
||||
We'd love you to contribute to Whalebird.
|
||||
|
||||
### Minimum requirements for development
|
||||
|
||||
* Node.js greater than or equal version 15.0.0 (18.x is recommended)
|
||||
* npm or yarn
|
||||
|
||||
### Getting started
|
||||
|
||||
``` bash
|
||||
# clone this repository
|
||||
$ git clone https://github.com/h3poteto/whalebird-desktop.git
|
||||
$ cd whalebird-desktop
|
||||
|
||||
# Install font config
|
||||
$ sudo apt-get install libfontconfig-dev
|
||||
|
||||
# install dependencies
|
||||
$ yarn install
|
||||
|
||||
# serve with hot reload at localhost:9080
|
||||
$ yarn run dev
|
||||
```
|
||||
|
||||
# License
|
||||
The software is available as open source under the terms of the [GPL-3.0 License](https://www.gnu.org/licenses/gpl-3.0.en.html). However, icons do not comply with this license, © Miho Fukuda.
|
||||
|
Loading…
Reference in New Issue
Block a user