Skip to content

mrassili/ferdi

Β 
Β 

Repository files navigation

Download

Ferdi

GitHub Releases Contributors Open Collective backers Open Collective sponsors Build Status Windows Build Status Mac & Linux

🀴🏽 Hard-fork of Franz, adding awesome features and removing unwanted ones.

Table of contents

Toggle navigation

What is Ferdi?

Ferdi is a messaging browser that allows you to combine your favorite messaging services into one application. It is based on Franz - a software already used by thousands of people - with the difference that Ferdi gives you many additonal features and doesn't restrict its usage! Ferdi is compatible with your existing Franz account so you can continue right where you left off. Find out more about Ferdi and its features on getferdi.com.

Features

  • Ferdi puts all your messaging services into one place
  • Native support for 100+ services
  • Workspaces to keep your personal and work life seperated
  • Support for multiple accounts on any service
  • Dark Mode support for all of your services
  • Optional cloud sync to keep your services synchronized between devices
  • Better control over when you get which notifications
  • Cross-platform so you can view your services on all your computers
  • Full proxy support to work in every network environment
  • Ferdi speaks your language: Support for 20+ languages

...and best of all:

  • Its completely free! There are no restrictions on features, no paywalls

What does Ferdi look like?

Toggle screenshots

Keep all your messaging services in one place. "Keep all your messaging services in one place." Order your services with Ferdi Workspaces. "Order your services with Ferdi Workspaces." Always keep your Todos list open with Ferdi Todos. "Always keep your Todos list open with Ferdi Todos." Supporting all your services. "Supporting all your services."

Download Ferdi

You can download Ferdi for Windows, Mac and Linux on Ferdi's download page or you can find all variants in the latest stable release assets and all the other release here.

Or use homebrew (macOS only)

$ brew cask install ferdi

(Don't know homebrew? brew.sh)

Or use AUR (Arch Linux)

Ferdi has three seperate AUR packages you can use:

  • ferdi: Uses your system electron version to run the latest release - this version will work best on most systems.
  • ferdi-bin: Uses the latest Fedora release and extracts it to Arch. Use this version if you are having trouble with the ferdi package.
  • ferdi-git: Uses your system electron version to run the latest commit from the develop branch and may be unstable but may also give you features that are not yet available in other versions. Please only use ferdi-git if you accept these risks.

If you use an AUR Helper e.g. yay, simply install it via yay -S ferdi.

What makes Ferdi different from Franz?

Removes unproductive paywalls and other other interruptions

  • Removes the counter-productive fullscreen app delay inviting users to upgrade
  • Removes pages begging you to donate after registration
  • Removes "Franz is better together" popup
  • Makes all users Premium by default (#15)

Adds features to increase your productivity

Adds features to improve your privacy

Adds features to improve your experience using Ferdi

  • Adds Universal Dark Mode via the DarkReader extension (#71)
  • Adds adaptable Dark Mode that will respect the system's Dark Mode setting (#173)
  • Adds ability to change the services icons size and sidebar width (#153)
  • Adds an option to auto-hide the menubar (#7, franz#833)
  • Enhances system tray icon behaviour (#307)
  • Adds option to show a browser-like navigation bar on all services
  • Adds option to change accent color
  • Reflects your currently opened service name to the window title to improve support for Password Managers (#213)
  • Allows using SVGs for service custom icon
  • Adds button to open darkmode.css for a service
  • Improves "About Ferdi" screen to better display versions
  • Adds option to start Ferdi in system tray (#331)
  • Fixes and enhances context menu (#357 #413 #452 #354 #227)
  • Adds better support for macOS dark mode
  • Adds option to disable reload of services after resuming Ferdi (#442)
  • Comes with a custom branding proper to Ferdi
  • Adds better seperation in settings
  • Adds various other UI improvements
  • Improves documentation of development so more developers can help making Ferdi even better

Removed bugs

  • Fixes bug that would incorrectly display unread messages count on some services (more info in 7566ccd)
  • Fixes zooming
  • Fixes login problems in Google services
  • Fixes missing Slack services custom icons (#290)
  • Fixes bug that marked valid domains as invalid (#276)
  • Fixes microphone/camera access on some versions of macOS (#193)

Adds new platforms

  • Adds portable version for Windows so you can use Ferdi without even installing it
  • Adds Arch Linux AUR packages
  • Adds Ferdi as a Flatpak on Flathub (#323)

Adds internal changes

  • Upgrades to Electron 8
  • Switches to electron-spellchecker to improve application size
  • Minifies build files to improve app size
  • Adds "npm run prepare-code" command for development to lint and beautify code
  • Fixes incorrect body closing tag (#330)
  • Uses CrowdIn to improve i18n

Thanks to all our contributors who helped realize all these amazing features! πŸ’–

Development

Install OS dependencies

Node.js

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.

Git

The version 2.23.0 for Git is working fine for development. You can then use the console from Git to do the development procedure.

Debian/Ubuntu

$ apt install libx11-dev libxext-dev libxss-dev libxkbfile-dev

Fedora

$ dnf install libX11-devel libXext-devel libXScrnSaver-devel libxkbfile-devel

Windows

$ npm install --global windows-build-tools --vs2015

Clone repository with submodule

$ git clone https://github.com/getferdi/ferdi.git
$ cd ferdi
$ git submodule update --init --recursive

It is important you execute the last command to get the required submodules (recipes, server).

Install dependencies

Run the following command to install all dependencies, and link sibling modules with Ferdi.

$ npx lerna bootstrap

If you previously ran npm install it sometimes is necessary to delete your node_modules folder before running npx lerna bootstrap.

Fix native modules to match current electron node version

$ npm run rebuild

Start development app

Run these two commands simultaneously in different terminals:

$ npm run dev
$ DEBUG=Ferdi:* npm run start

Optionally, you can run both commands in one terminal with misty (see misty.yml):

$ DEBUG=Ferdi:* npx misty

Note: please prefer debug() over console.log().

Packaging

$ npm run build

Deliverables will be available in the out folder.

Release

$ git checkout develop && git pull
$ git submodule update --remote --force
$ git add .
$ git commit -m "Update submodules"
$ git checkout master
$ git merge --no-ff develop
$ git tag v5.3.4-beta.4
$ git push --tags

When pushing a new tag, the CI builds will create a draft GitHub release and upload the deliverables in the draft release assets. Wait for all the assets to be uploaded before publishing the draft release.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Bennett
Bennett

πŸ’» 🎨 πŸ“– πŸ€” 🌍 πŸ’‘ πŸ› πŸ–‹ πŸš‡ πŸ““ πŸ’¬ πŸ“† πŸ‘€
Amine Mouafik
Amine Mouafik

πŸ’» 🎨 πŸ“– πŸ€” πŸ› πŸ–‹ πŸš‡ πŸ““ πŸ’¬ πŸ“† πŸ‘€ 🚧 πŸ“¦ πŸ” πŸ“ 🌍
Stefan Malzner
Stefan Malzner

πŸ’» πŸ–‹ 🎨 πŸ“– πŸ€” πŸš‡ πŸ“† ⚠️ 🌍
Makazzz
Makazzz

πŸ› πŸ’» 🌍 πŸ–‹ πŸ“– πŸ“¦
ZeroCool
ZeroCool

πŸ’» πŸ€”
rseitbekov
rseitbekov

πŸ’»
Peter Bittner
Peter Bittner

πŸ€” πŸ›
Justus Saul
Justus Saul

πŸ› πŸ€”
igreil
igreil

πŸ€”
Marco Lopes
Marco Lopes

πŸ€”
dayzlun
dayzlun

πŸ›
Tobias GΓΌnther
Tobias GΓΌnther

πŸ€”
AGCaesar
AGCaesar

πŸ“¦
xthursdayx
xthursdayx

πŸ’» πŸ“– πŸš‡ πŸ“¦
Gaboris
Gaboris

πŸ’¬ πŸ›
Ce
Ce

πŸ›
Stanislav N.
Stanislav N.

πŸ›
Patrick Curl
Patrick Curl

πŸ€”
Benjamin Staneck
Benjamin Staneck

🎨
ammarmalhas
ammarmalhas

πŸ› πŸ›‘οΈ
Steliyan Stoyanov
Steliyan Stoyanov

πŸ’» πŸ€”
Bror Winther
Bror Winther

πŸ“–
Felix W. Dekker
Felix W. Dekker

πŸ“–
Sauceee
Sauceee

🎨
Lennart Weller
Lennart Weller

πŸ“¦
Andrzej Ressel
Andrzej Ressel

πŸ’»
Daniel Peukert
Daniel Peukert

πŸ’»
Ali M. Shiple
Ali M. Shiple

🌍
elviseras
elviseras

🌍
J370
J370

🌍
Koen
Koen

🌍
Leandro Gehlen
Leandro Gehlen

🌍
Matthieu42
Matthieu42

🌍
Nikita Bibanaev
Nikita Bibanaev

🌍
Tatjana1998
Tatjana1998

🌍
tinect
tinect

🌍
Wonsup Yoon
Wonsup Yoon

🌍
zutt
zutt

🌍
n0emis
n0emis

πŸ’» 🌍
gmarec
gmarec

πŸ’»
127oo1
127oo1

🌍
ChTBoner
ChTBoner

🌍
Johan Engstrand
Johan Engstrand

🌍

This project follows the all-contributors specification. Contributions of any kind welcome!

Backers via OpenCollective

Sponsors via OpenCollective

About

πŸ§”πŸ½ Community fork of @meetfranz. Ferdi allows you to combine your favourite messaging services into one application

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 84.1%
  • TypeScript 9.3%
  • CSS 6.3%
  • HTML 0.3%