aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md88
1 files changed, 67 insertions, 21 deletions
diff --git a/README.md b/README.md
index 5397189c6..50bc214fd 100644
--- a/README.md
+++ b/README.md
@@ -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
7Messaging 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
14You 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
46Please 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
36If you previously ran `npm install` it sometimes is necessary to delete your `node_modules` folder before running `npx lerna bootstrap`. 59If 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
39Run these two commands __simultaneously__ in different console tabs. 62Run 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? 75Deliverables will be available in the ./out folder.
53If 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
56Join the Franz community on [Slack](http://slack.franz.im) and get in touch with us. 79Thanks 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 -->
59You can find all the Information at the [Plugins repository](https://github.com/meetfranz/plugins). 82<table>
60For 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>
63Franz 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
109This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!