Folio

Take notes in markdown

A beautiful markdown note-taking app for GNOME (forked from Paper).

Contributions are appreciated!

Some of Folio's features:

• Almost WYSIWYG markdown rendering

• Searchable through GNOME search

• Highlight and strikethrough text formatting

• Application theming based on notebook color

• Trash can

• Markdown document

Get Folio

The recommended way of installing Folio is through our Flatpak:

From Flathub

Manual

Go to the current GitHub Releases page, select the latest release, and download the asset called Folio-YY.##.flatpak. Once downloaded, use flatpak install Folio-YY.##.flatpak to install Folio on your computer.

You can use the same process to update to a newer release as well.

Libraries Used

• libadwaita
• gtksourceview-5

License

The source code is GPLv3

Notes Storage

By default, notes are stored in ~/.var/app/com.toolstack.Folio/data, but that can be changed in preferences

Translations

Folio has been translated into several different languages by users. Previously this was done by submitting pull requests to add the various language files.

Folio now has an online localization portal, if you would like to participate in translating Folio, send an e-mail and request access for the language you would like to translate.

Build Instructions

Flatpak build requires flatpak-building installed.

Local builds (NOT RECOMMENDED)

• change into the top level source directory
• to configure the build environment (required only once), run meson build
• change into the build directory
• to build Folio, run ninja
• to install Folio, run ninja install
• to run Folio, run src/com.toolstack.Folio

Flatpak builds

• change into the top level source directory
• to build the flatpak, run flatpak-builder --force-clean flatpak com.toolstack.Folio.json
• to build and install the flatpak, run flatpak-builder --user --install --force-clean flatpak com.toolstack.Folio.json
• to launch the flatpak, run flatpak run com.toolstack.Folio

Release instructions

Folio uses a YY.## version format string, where YY is the two digit year (aka 23, 24, 25, etc) and ## is the release number of the year (aka 01 for the first release, 02 for the second release, etc., not the month number).

The release version is located in the main meson.build file, no other files contain the version number.

The full changelog is located in data/app.metainfo.xml.in and the current release for the about dialog is in src/application.vala.

Generate translation POT

Folio uses POT/PO files for it's translations, the POT file defines all the strings that are used by Folio.

Before generating the POT file you must have already run meson for the first time and have run a local build.

To generate the POT file:

• change into the PO directory
• run ./print-source-files.sh > POTFILES
• change into the build directory: cd ../build
• run meson compile com.toolstack.Folio-pot