diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 88 |
1 files changed, 67 insertions, 21 deletions
@@ -1,20 +1,40 @@ | |||
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 | [![Build Status Windows](https://ci.appveyor.com/api/projects/status/2ckfbmoxp36fye5b?svg=true)](https://ci.appveyor.com/project/kytwb/ferdi) |
8 | [![Build Status Mac & Linux](https://travis-ci.org/kytwb/ferdi.svg?branch=master)](https://travis-ci.org/kytwb/ferdi) | ||
8 | 9 | ||
9 | ## [Download Franz](https://www.meetfranz.com) | 10 | π€΄π½ Hard-fork of [Franz](https://github.com/meetfranz/franz), adding awesome features and removing unwanted features. |
10 | π www.meetfranz.com | 11 | |
12 | ## Download Ferdi | ||
13 | |||
14 | You can find the installers in the [latest release](https://github.com/kytwb/ferdi/releases) assets. | ||
11 | 15 | ||
12 | ### Or use homebrew (macOS only) | 16 | ### Or use homebrew (macOS only) |
13 | 17 | ||
14 | `$ brew cask install franz` | 18 | `$ brew cask install ferdi` |
15 | 19 | ||
16 | (Don't know homebrew? [brew.sh](https://brew.sh/)) | 20 | (Don't know homebrew? [brew.sh](https://brew.sh/)) |
17 | 21 | ||
22 | ## Features | ||
23 | - [x] Removes the counter-productive fullscreen app delay inviting users to upgrade | ||
24 | - [x] Removes pages begging you to donate after registration | ||
25 | - [x] Makes all users Premium by default ([#15](https://github.com/kytwb/ferdi/issues/15)) | ||
26 | - [x] [Add option to change server to a custom](https://github.com/kytwb/ferdi/wiki/Custom-Server) [ferdi-server](https://github.com/vantezzen/ferdi-server) | ||
27 | - [x] Add "Private Notification"-Mode, that hides message content from notifications ([franz#879](https://github.com/meetfranz/franz/issues/879)) | ||
28 | - [x] Add Password Lock feature to keep your messages protected ([#41](https://github.com/kytwb/ferdi/issues/41) and [franz#810](https://github.com/meetfranz/franz/issues/810), [franz#950](https://github.com/meetfranz/franz/issues/950), [franz#1430](https://github.com/meetfranz/franz/issues/1430)) | ||
29 | - [x] Add an option to keep individual workspaces always loaded ([#37](https://github.com/kytwb/ferdi/issues/37)) | ||
30 | - [x] Add an option to auto-hide the menubar ([#7](https://github.com/kytwb/ferdi/issues/7), [franz#833](https://github.com/meetfranz/franz/issues/833)) | ||
31 | - [x] Add CTRL+β and CTRL+β shortcuts and menu options to go back and forward in the service browsing history([#39](https://github.com/kytwb/ferdi/issues/39)) | ||
32 | - [x] Add "npm run prepare-code" command for development to lint and beautify code | ||
33 | - [x] Remove "Franz is better together" popup | ||
34 | - [x] [Makes it possible to edit the "Franz Todo" server](https://github.com/kytwb/ferdi/wiki/Custom-Todo) | ||
35 | - [x] Makes RocketChat self-hosted generally available ([#6](https://github.com/kytwb/ferdi/issues/6)) | ||
36 | - [x] Comes with a custom branding proper to Ferdi | ||
37 | |||
18 | ## Development | 38 | ## Development |
19 | 39 | ||
20 | ### Preparations | 40 | ### Preparations |
@@ -22,6 +42,9 @@ Messaging app for WhatsApp, Slack, Telegram, HipChat, Hangouts and many many mor | |||
22 | #### Install Linux OS dependencies | 42 | #### Install Linux OS dependencies |
23 | [Guide: Linux distribution specific dependencies](docs/linux.md) | 43 | [Guide: Linux distribution specific dependencies](docs/linux.md) |
24 | 44 | ||
45 | #### Use right NodeJS version | ||
46 | Please make sure you are running NodeJS v10 (v10.16.3 suggested). Versions above will throw an errow when trying to install due to an [old fsevent dependency](https://github.com/fsevents/fsevents/issues/278) | ||
47 | |||
25 | #### Fix native modules to match current electron node version | 48 | #### Fix native modules to match current electron node version |
26 | ```bash | 49 | ```bash |
27 | $ npm run rebuild | 50 | $ npm run rebuild |
@@ -35,7 +58,7 @@ $ npx lerna bootstrap | |||
35 | 58 | ||
36 | If you previously ran `npm install` it sometimes is necessary to delete your `node_modules` folder before running `npx lerna bootstrap`. | 59 | If you previously ran `npm install` it sometimes is necessary to delete your `node_modules` folder before running `npx lerna bootstrap`. |
37 | 60 | ||
38 | ### Run Franz Development App | 61 | ### Run Ferdi Development App |
39 | Run these two commands __simultaneously__ in different console tabs. | 62 | Run these two commands __simultaneously__ in different console tabs. |
40 | 63 | ||
41 | ```bash | 64 | ```bash |
@@ -49,15 +72,38 @@ Be aware that the development database will be reset regularly. | |||
49 | $ npm run build | 72 | $ npm run build |
50 | ``` | 73 | ``` |
51 | 74 | ||
52 | ## How can I support the project? | 75 | 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. | 76 | |
54 | 77 | ## Contributors β¨ | |
55 | ## I need help? | 78 | |
56 | Join the Franz community on [Slack](http://slack.franz.im) and get in touch with us. | 79 | Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): |
57 | 80 | <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> | |
58 | ## Create your own plugins/recipes | 81 | <!-- prettier-ignore --> |
59 | You can find all the Information at the [Plugins repository](https://github.com/meetfranz/plugins). | 82 | <table> |
60 | For questions feel free to ask in the [community Slack](http://slack.franz.im) | 83 | <tr> |
61 | 84 | <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> | |
62 | ## License | 85 | <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> |
63 | Franz 5 is open-source licensed under the Apache-2.0 License. | 86 | <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> |
87 | <td align="center"><a href="http://seriesgt.com"><img src="https://avatars3.githubusercontent.com/u/5977640?v=4" width="100px;" alt="ZeroCool"/><br /><sub><b>ZeroCool</b></sub></a><br /><a href="https://github.com/kytwb/ferdi/commits?author=ZeroCool940711" title="Code">π»</a> <a href="#ideas-ZeroCool940711" title="Ideas, Planning, & Feedback">π€</a></td> | ||
88 | <td align="center"><a href="https://github.com/rseitbekov"><img src="https://avatars2.githubusercontent.com/u/35684439?v=4" width="100px;" alt="rseitbekov"/><br /><sub><b>rseitbekov</b></sub></a><br /><a href="https://github.com/kytwb/ferdi/commits?author=rseitbekov" title="Code">π»</a></td> | ||
89 | <td align="center"><a href="https://djangogigs.com/developers/peter-bittner/"><img src="https://avatars2.githubusercontent.com/u/665072?v=4" width="100px;" alt="Peter Bittner"/><br /><sub><b>Peter Bittner</b></sub></a><br /><a href="#ideas-bittner" title="Ideas, Planning, & Feedback">π€</a></td> | ||
90 | <td align="center"><a href="https://github.com/justus-saul"><img src="https://avatars1.githubusercontent.com/u/5861826?v=4" width="100px;" alt="Justus Saul"/><br /><sub><b>Justus Saul</b></sub></a><br /><a href="https://github.com/kytwb/ferdi/issues?q=author%3Ajustus-saul" title="Bug reports">π</a> <a href="#ideas-justus-saul" title="Ideas, Planning, & Feedback">π€</a></td> | ||
91 | </tr> | ||
92 | <tr> | ||
93 | <td align="center"><a href="https://github.com/igreil"><img src="https://avatars0.githubusercontent.com/u/17239151?v=4" width="100px;" alt="igreil"/><br /><sub><b>igreil</b></sub></a><br /><a href="#ideas-igreil" title="Ideas, Planning, & Feedback">π€</a></td> | ||
94 | <td align="center"><a href="http://marcolopes.eu"><img src="https://avatars1.githubusercontent.com/u/431889?v=4" width="100px;" alt="Marco Lopes"/><br /><sub><b>Marco Lopes</b></sub></a><br /><a href="#ideas-marcolopes" title="Ideas, Planning, & Feedback">π€</a></td> | ||
95 | <td align="center"><a href="https://github.com/dayzlun"><img src="https://avatars3.githubusercontent.com/u/17259690?v=4" width="100px;" alt="dayzlun"/><br /><sub><b>dayzlun</b></sub></a><br /><a href="https://github.com/kytwb/ferdi/issues?q=author%3Adayzlun" title="Bug reports">π</a></td> | ||
96 | <td align="center"><a href="https://twitter.com/tobigue_"><img src="https://avatars2.githubusercontent.com/u/1560152?v=4" width="100px;" alt="Tobias GΓΌnther"/><br /><sub><b>Tobias GΓΌnther</b></sub></a><br /><a href="#ideas-tobigue" title="Ideas, Planning, & Feedback">π€</a></td> | ||
97 | </tr> | ||
98 | </table> | ||
99 | |||
100 | <!-- ALL-CONTRIBUTORS-LIST:END --> | ||
101 | |||
102 | <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> | ||
103 | <!-- prettier-ignore-start --> | ||
104 | <!-- markdownlint-disable --> | ||
105 | <!-- markdownlint-enable --> | ||
106 | <!-- prettier-ignore-end --> | ||
107 | <!-- ALL-CONTRIBUTORS-LIST:END --> | ||
108 | |||
109 | This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! | ||