diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 120 |
1 files changed, 71 insertions, 49 deletions
@@ -1,63 +1,85 @@ | |||
1 | <img src="./build-helpers/images/icon.png" alt="" width="150"/> | 1 | <p align="center"> |
2 | <img src="./build-helpers/images/icon.png" alt="" width="200"/> | ||
3 | </p> | ||
2 | 4 | ||
3 | # Franz 5 | 5 | # Ferdi |
4 | [![Build status Windows](https://ci.appveyor.com/api/projects/status/9yman4ye19x4274o/branch/master?svg=true)](https://ci.appveyor.com/project/adlk/franz/branch/master) | ||
5 | [![Build Status Mac & Linux](https://travis-ci.com/meetfranz/franz.svg?branch=master)](https://travis-ci.com/meetfranz/franz) [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://meetfranz.com/payment.html) | ||
6 | 6 | ||
7 | Messaging app for WhatsApp, Slack, Telegram, HipChat, Hangouts and many many more. | 7 | 🤴🏽 Hard-fork of [Franz](https://github.com/meetfranz/franz), adding awesome features and removing unwanted features. |
8 | 8 | ||
9 | ## [Download Franz](https://www.meetfranz.com) | 9 | ## Features |
10 | 👉 www.meetfranz.com | 10 | - [x] Removes the counter-productive fullscreen app delay inviting users to upgrade |
11 | - [x] Removes pages begging you to donate after registration | ||
12 | - [x] Makes all users Premium by default | ||
13 | - [x] [Add option to change server to a custom](#servers) [ferdi-server](https://github.com/vantezzen/ferdi-server) | ||
14 | - [x] Remove "Franz is better together" popup | ||
15 | - [x] Makes RocketChat self-hosted generally available | ||
16 | - [x] Comes with a custom branding proper to Ferdi | ||
11 | 17 | ||
12 | ### Or use homebrew (macOS only) | 18 | ## Servers |
19 | Ferdi adds the option to change your Ferdi server. By default, this will be `https://api.franzinfra.com` - the official Franz server. This allows Ferdi to stay compatible with your current Franz account. | ||
13 | 20 | ||
14 | `$ brew cask install franz` | 21 | If you want to experience all Ferdi features, you may want to use a custom [ferdi-server](https://github.com/vantezzen/ferdi-server). ferdi-server allows you to use Premium features without restrictions and adds the ability to package and add additional recipes. You can also import your existing Franz account into your ferdi-server to start right where you left off. |
15 | 22 | ||
16 | (Don't know homebrew? [brew.sh](https://brew.sh/)) | 23 | More information on how to set up a ferdi-server can be found at <https://github.com/vantezzen/ferdi-server/blob/master/README.md>. |
17 | 24 | ||
18 | ## Development | ||
19 | |||
20 | ### Preparations | ||
21 | |||
22 | #### Install Linux OS dependencies | ||
23 | [Guide: Linux distribution specific dependencies](docs/linux.md) | ||
24 | |||
25 | #### Fix native modules to match current electron node version | ||
26 | ```bash | ||
27 | $ npm run rebuild | ||
28 | ``` | ||
29 | |||
30 | ### Install dependencies | ||
31 | Run the following command to install all dependencies, and link sibling modules with Franz. | ||
32 | ```bash | ||
33 | $ npx lerna bootstrap | ||
34 | ``` | ||
35 | |||
36 | If you previously ran `npm install` it sometimes is necessary to delete your `node_modules` folder before running `npx lerna bootstrap`. | ||
37 | |||
38 | ### Run Franz Development App | ||
39 | Run these two commands __simultaneously__ in different console tabs. | ||
40 | |||
41 | ```bash | ||
42 | $ npm run dev | ||
43 | $ npm run start | ||
44 | ``` | ||
45 | Be aware that the development database will be reset regularly. | ||
46 | 25 | ||
47 | ## Packaging | 26 | ## Packaging |
27 | |||
48 | ```bash | 28 | ```bash |
29 | $ npm install | ||
49 | $ npm run build | 30 | $ npm run build |
50 | ``` | 31 | ``` |
51 | 32 | ||
52 | ## How can I support the project? | 33 | Deliverables will be available in the `./out` folder. |
53 | If you have found a bug that hasn't been reported yet or want to request a new feature, please open a new issue. | ||
54 | |||
55 | ## I need help? | ||
56 | Join the Franz community on [Slack](http://slack.franz.im) and get in touch with us. | ||
57 | 34 | ||
58 | ## Create your own plugins/recipes | 35 | ## Developing |
59 | You can find all the Information at the [Plugins repository](https://github.com/meetfranz/plugins). | 36 | ### Preparations |
60 | For questions feel free to ask in the [community Slack](http://slack.franz.im) | 37 | - [Install Linux dependencies](docs/linux.md) if you are developing on Linux |
61 | 38 | - Make sure you are running NodeJS v10. Versions above will throw an errow when trying to install due to an [old fsevent dependency](https://github.com/fsevents/fsevents/issues/278) | |
62 | ## License | 39 | |
63 | Franz 5 is open-source licensed under the Apache-2.0 License. | 40 | ### Setup |
41 | 1. Fix native modules to match current electron node version | ||
42 | ``` | ||
43 | npm run rebuild | ||
44 | ``` | ||
45 | 2. Install dependencies using lerna | ||
46 | ``` | ||
47 | npx lerna bootstrap | ||
48 | ``` | ||
49 | 3. Run Ferdi Development App | ||
50 | Run these two commands *simultaneously* in different console tabs. | ||
51 | ``` | ||
52 | npm run dev | ||
53 | npm run start | ||
54 | ``` | ||
55 | |||
56 | ## Releases | ||
57 | |||
58 | You can find the binaries for Linux, MacOS and Windows in the [latest release](https://github.com/kytwb/Ferdi/releases/tag/Ferdi-5.2.0-beta.3) assets. Assets are continuously delivered through [Travis](https://travis-ci.org/kytwb/Ferdi) for Linux/MacOS and [Appveyor](https://ci.appveyor.com/project/kytwb/Ferdi) for Windows. | ||
59 | |||
60 | ## Contributors ✨ | ||
61 | |||
62 | Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): | ||
63 | <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> | ||
64 | <!-- prettier-ignore-start --> | ||
65 | <!-- markdownlint-disable --> | ||
66 | <table> | ||
67 | <tr> | ||
68 | <td align="center"><a href="https://twitter.com/kytwb"><img src="https://avatars0.githubusercontent.com/u/412895?v=4" width="100px;" alt="Amine Mouafik"/><br /><sub><b>Amine Mouafik</b></sub></a><br /><a href="#question-kytwb" title="Answering Questions">💬</a> <a href="https://github.com/kytwb/ferdi/commits?author=kytwb" title="Code">💻</a> <a href="https://github.com/kytwb/ferdi/commits?author=kytwb" title="Documentation">📖</a> <a href="#ideas-kytwb" title="Ideas, Planning, & Feedback">🤔</a> <a href="#maintenance-kytwb" title="Maintenance">🚧</a> <a href="#platform-kytwb" title="Packaging/porting to new platform">📦</a> <a href="#projectManagement-kytwb" title="Project Management">📆</a> <a href="#review-kytwb" title="Reviewed Pull Requests">👀</a></td> | ||
69 | <td align="center"><a href="https://vantezzen.io"><img src="https://avatars2.githubusercontent.com/u/10333196?v=4" width="100px;" alt="Bennett"/><br /><sub><b>Bennett</b></sub></a><br /><a href="https://github.com/kytwb/ferdi/commits?author=vantezzen" title="Code">💻</a> <a href="#design-vantezzen" title="Design">🎨</a> <a href="https://github.com/kytwb/ferdi/commits?author=vantezzen" title="Documentation">📖</a> <a href="#ideas-vantezzen" title="Ideas, Planning, & Feedback">🤔</a> <a href="#translation-vantezzen" title="Translation">🌍</a></td> | ||
70 | <td align="center"><a href="http://www.adlk.io"><img src="https://avatars1.githubusercontent.com/u/3265004?v=4" width="100px;" alt="Stefan Malzner"/><br /><sub><b>Stefan Malzner</b></sub></a><br /><a href="https://github.com/kytwb/ferdi/commits?author=adlk" title="Code">💻</a> <a href="#content-adlk" title="Content">🖋</a> <a href="#design-adlk" title="Design">🎨</a> <a href="https://github.com/kytwb/ferdi/commits?author=adlk" title="Documentation">📖</a> <a href="#ideas-adlk" title="Ideas, Planning, & Feedback">🤔</a> <a href="#infra-adlk" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#projectManagement-adlk" title="Project Management">📆</a> <a href="https://github.com/kytwb/ferdi/commits?author=adlk" title="Tests">⚠️</a> <a href="#translation-adlk" title="Translation">🌍</a></td> | ||
71 | </tr> | ||
72 | </table> | ||
73 | |||
74 | <!-- markdownlint-enable --> | ||
75 | <!-- prettier-ignore-end --> | ||
76 | <!-- ALL-CONTRIBUTORS-LIST:END --> | ||
77 | |||
78 | <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> | ||
79 | <!-- prettier-ignore-start --> | ||
80 | <!-- markdownlint-disable --> | ||
81 | <!-- markdownlint-enable --> | ||
82 | <!-- prettier-ignore-end --> | ||
83 | <!-- ALL-CONTRIBUTORS-LIST:END --> | ||
84 | |||
85 | This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! | ||