Unofficial Franz server replacement for use with the Ferdi Client.
Looking for a smaller alternative?
ferdi-slim-server is a slim alternative to this project. Opposed to ferdi-server, ferdi-slim-server is only a wrapper around the Franz API that allows you to add custom recipes while still using the original Franz API.
Why use a custom ferdi-server?
A custom ferdi-server allows you to experience the full potential of the Ferdi client. It allows you to use all Premium features (e.g. Workspaces and custom URL recipes) and adding your own recipes.
You can try a demo of ferdi-server by settings your server to https://ferdi.vantezzen.io.
- User registration and login
- Service creation, download, listing and removing
- Workspace support
- Functioning service store
- User dashboard
- Password recovery
- Export/import data to other ferdi-servers
- Recipe update
- Clone this repository
- Install the AdonisJS CLI
.envand edit the configuration to your needs
npm installto install local dependencies
- Run the database migrations with
- Start the server with
adonis serve --dev
franz-server's configuration is saved inside the
.env file. Besides AdonisJS's settings, ferdi-server has the following custom settings:
true): Whether to enable the creation of custom recipes
true): Whether to enable connections to the Franz server. By enabling this option, ferdi-server can:
- Show the full Franz recipe library instead of only custom recipes
- Import Franz accounts
Importing your Franz account
ferdi-server allows you to import your full Franz account, including all its settings.
To import your Franz account, open
http://[YOUR FERDI-SERVER]/import in your browser and login using your Franz account details. ferdi-server will create a new user with the same credentials and copy your Franz settings, services and workspaces.
Creating and using custom recipes
ferdi-server allows to extends the Franz recipe catalogue with custom Ferdi recipes.
For documentation on how to create a recipe, please visit the official guide by Franz.
To add your recipe to ferdi-server, open
http://[YOUR FERDI-SERVER]/new in your browser. You can now define the following settings:
Author: Author who created the recipe
Name: Name for your new service. Can contain spaces and unicode characters
Service ID: Unique ID for this recipe. Does not contain spaces or special characters (e.g.
Link to PNG/SVG image: Direct link to a 1024x1024 PNG image and SVG that is used as a logo inside the store. Please use jsDelivr when using a file uploaded to GitHub as raw.githubusercontent files won't load
Recipe files: Recipe files that you created using the Franz recipe creation guide. Please do not package your files beforehand - upload the raw files (you can drag and drop multiple files). ferdi-server will automatically package and store the recipe in the right format. Please also do not drag and drop or select the whole folder, select the individual files.
Listing custom recipes
Inside Ferdi, searching for
ferdi:custom will list all your custom recipes.
ferdi-server is licensed under the MIT License