/ferdi

πŸ§”πŸ½ Ferdi helps you organize how you use your favourite apps by combining them into one application

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Download

Ferdi

GitHub Releases Contributors Open Collective backers Open Collective sponsors Build Status Gitter Chat Room

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

Table of contents

Toggle navigation

What is Ferdi?

Ferdi is a desktop app that helps you organize how you use your favourite apps by combining them into one application. It is based on Franz - a software already used by thousands of people - with the difference that Ferdi gives you many additional 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 web apps into one place
  • Native support for 100+ services
  • Workspaces to keep your personal and work life separated
  • 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."

How to get and start using Ferdi

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 Chocolatey (Windows only)

$ choco install ferdi

(Don't know Chocolatey? chocolatey.org)

Or use Windows Package Manager (Windows only)

$ winget install --id AmineMouafik.Ferdi

(Don't know winget? winget-cli)

Or use homebrew (macOS or Linux)

$ brew install --cask ferdi

(Don't know homebrew? brew.sh)

Or use snap (Linux only)

$ snap install ferdi

You can find published releases as stable, beta and nightly channels on snapcraft.io.

(Don't know snap? snapcraft.io)

Or use AUR (Arch Linux)

Ferdi has three separate 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 Dark Reader settings (#531, #568), πŸ’– @Room4O4 & @mahadevans87
  • Adds adaptable Dark Mode that will respect the system's Dark Mode setting (#173, #548 (πŸ’– @Room4O4 & @mahadevans87))
  • Adds a hotkey to quickly toggle darkmode (#530, #537), πŸ’– @Room4O4 & @mahadevans87
  • Adds an option to start Ferdi minimized (#490, #534)
  • 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 draggable window area on macOS (#304, #532)
  • Adds a notification & audio toggle action to the tray context menu (#542), πŸ’– @Room4O4 & @mahadevans87
  • 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), πŸ’– @gmarec
  • Allows using SVGs for service custom icon
  • Adds button to open darkmode.css for a service
  • Improves "About Ferdi" screen to better display versions
  • Improves user onboarding (#493)
  • Improves "Updates" section in settings (#506), πŸ’– @yourcontact
  • Improves draggable window area height for macOS (#304, #479)
  • Adds option to start Ferdi in system tray (#331), πŸ’– @jereksel
  • 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), πŸ’– @n0emis
  • Comes with a custom branding proper to Ferdi
  • Adds better separation in settings
  • Adds various other UI improvements
  • Improves documentation of development so more developers can help making Ferdi even better
  • Updates Microsoft Teams to allow Desktop Sharing (getferdi/recipes#116), πŸ’– @Gautasmi
  • Removes automatic reloading from WhatsApp

Fixes 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)
  • Fixes cache clearing not working in Windows 10 (#541, #544), πŸ’– @Room4O4 & @mahadevans87
  • Fixes Home button in navigation bar not correctly navigating (#571, #573), πŸ’– @Room4O4 & @mahadevans87
  • Fixes notifications for various services, πŸ’– @FeikoJoosten
  • Refocuses Webview only for active service (#610), πŸ’– @Room4O4 & @mahadevans87

Adds new platforms

  • Adds portable version for Windows so you can use Ferdi without even installing it, πŸ’– @Makazzz
  • Adds Arch Linux AUR packages, πŸ’– @AGCaesar
  • Adds Ferdi as a Flatpak on Flathub (#323), πŸ’– @lhw

Adds internal changes

  • Upgrades to Electron 13.2.1
  • 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
  • Adds "npm run link-readme" command to automatically add links to issues and users inside README.md
  • Fixes incorrect body closing tag (#330), πŸ’– @jereksel
  • Uses CrowdIn to improve i18n
  • Adds retry commands to flaky build steps (#498)
  • Runs utility scripts pre-commit instead of pre-push (#515)

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

Contributing to Ferdi's development

We welcome all contributors. Please read the contributing guidelines to setup your development machine and proceed.

Nightly releases

Nightly releases are automatically triggered every day (details) and available in getferdi/nightlies. Maintainers still need to manually publish the draft releases as pre-releases for now.

Troubleshooting recipes (self-help)

One of the issues being raised by the awesome users of Ferdi is that certain service-functionalities do not work. As good example of this is either the unread count (badge) stops working for specific services or the gmail logins don't work anymore. (These are just 2 of the most common problems reported).

Since we (the contributors to Ferdi) also eat our own dog food, we use Ferdi as our day-to-day communication app - and most likely have faced the same/similar issue. As a first step before filing an issue, we request you to follow these simple steps to see if the issue gets fixed. These recipes will get automatically upgraded when you upgrade to the newer versions of Ferdi, but to get new recipes between Ferdi releases, this documentation is quite useful.

  • Make sure you are on the latest version of Ferdi. As of this writing, since the nightly CI packaging process is broken, we request you to download the latest nightly from the link in Nightly releases section.
  • Stop Ferdi
  • Navigate to the Ferdi profile folder in your respective installation in your file explorer application.
  Mac: ~/Library/Application Support/Ferdi/recipes
  Windows: %appdata%/Ferdi/recipes
  Linux: ~/.config/Ferdi/recipes
  • Delete the folder of the service that is causing your issue - in the file explorer application. (Please note that if you have manually modified any files here, it will be your responsibility to merge the changes with the latest version of the recipe (or you can submit a pull request for the same).
  • Open a browser and navigate to the recipes repository page, and copy ALL the files for your erroneous service into your local machine at the location that you deleted in the previous step
  • Restart Ferdi (this should upgrade your recipes to the latest working version that the contributors have fixed)
  • If this process did not fix the issue, please log a detailed bug report here
  • Note: An automated process to perform these steps is being ideated and tracked here

Contributors ✨

Thanks goes to these awesome people:

vantezzen kytwb adlk Makazzz ZeroCool940711 rseitbekov bittner justus-saul igreil marcolopes dayzlun tobigue AGCaesar xthursdayx Gaboris incace
pztrn patrickcurl Stanzilla ammarmalhas steliyan brorbw FWDekker Sauceee lhw jereksel dpeukert Ali_Shiple elviseras J370 keunes leandrogehlen
Matthieu42 nicky18013 Tatjana1998 seayko Pusnow zutt n0emis gmarec 127oo1 ChTBoner johanengstrand mrassili yourcontact mahadevans87 JakeSteam sampathBlam
saruwman dorukkarinca gautamsi FeikoJoosten 2bdelghafour abdoutanta AndiLeni brunofalmada Catarino Alzemand MAT-OUT mazzo98 paprika-naught-tiffin-flyspeck patrickvalle peq42 karlinhos
dies SMile61 tinect gega7 tristanplouz dannyqiu belyazidi56 gabspeck dandelionadia janhohner kris7t raicerk tofran digitalcoyote kawarimidoll 1mm0rt41PC
k0staa arioki1 MosheGross stnkl vraravam alopix jakobsudau prasann markandan mhatvan sergiughf ArviTheMan eltociear madsmtm mloskot skoshy
graves501

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

Backers via OpenCollective

Mention to the individuals backing us via GitHub Sponsors as well.

Sponsors via OpenCollective

Other Sponsors