Ferdi

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

Toggle navigation

Ferdi

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.

What does Ferdi look like?

Toggle screenshots

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

Download Ferdi

You can find the installers 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 two seperate AUR packages you can use:

ferdi-bin: Uses your debian build and extracts it to Arch
ferdi-git: Uses system electron version

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

ferdi-git may not work on all systems so we advice you to use ferdi-bin instead.

Ferdi-specific 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 console tabs:

$ npm run dev
$ npm run start

Be aware that the development database will be reset regularly.

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 💻 🎨 📖 🤔 🌍 💡 🐛 🖋 🚇 📓 💬 📆 👀	_{Stefan Malzner} 💻 🖋 🎨 📖 🤔 🚇 📆 ⚠️ 🌍	_{Amine Mouafik} 💬 💻 📖 🤔 🚧 📦 📆 👀 🚇 🔍 📝	_ZeroCool 💻 🤔	_rseitbekov 💻	_{Peter Bittner} 🤔 🐛
_{Justus Saul} 🐛 🤔	_igreil 🤔	_{Marco Lopes} 🤔	_dayzlun 🐛	_{Tobias Günther} 🤔	_AGCaesar 📦
_Makazzz 🐛 💻 🌍 🖋 📖 📦	_xthursdayx 💻 📖 🚇 📦	_Gaboris 💬 🐛	_Ce 🐛	_{Stanislav N.} 🐛	_{Patrick Curl} 🤔
_{Benjamin Staneck} 🎨	_ammarmalhas 🐛 🛡️	_{Steliyan Stoyanov} 💻 🤔	_{Bror Winther} 📖	_{Felix W. Dekker} 📖	_Sauceee 🎨
_{Lennart Weller} 📦	_{Andrzej Ressel} 💻