A beautiful markdown note-taking app for GNOME (forked from Paper)
GPL-3.0 License
A beautiful markdown note-taking app for GNOME (forked from Paper).
Contributions are appreciated, see below for how to help translate Folio!
The recommended way of installing Folio is through Flatpak or Snap or as an AppImage:
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.
The source code is GPLv3
By default, notes are stored in ~/.var/app/com.toolstack.Folio/data
,
but that can be changed in preferences
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.
Flatpak build requires flatpak-building installed.
meson build
ninja
ninja install
src/com.toolstack.Folio
flatpak-builder --force-clean flatpak com.toolstack.Folio.json
flatpak-builder --user --install --force-clean flatpak com.toolstack.Folio.json
flatpak run com.toolstack.Folio
snapcraft
sudo snap install ./folio_YY.XX_amd64.snap --dangerous
folio
./folio.build.appimage.sh
./Folio-x86_64.AppImage
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
.
Before doing a release, make sure to e-mail the translation editors to let them know to update the translations. This should be done at least 2 days in advance to give them time to make their updates. Once they update are done, make sure to export the translations and commit them to git.
Once updated, edit the flatpak and snap files:
com.toolstack.Folio.json
and update the tag
value for sources, also remove the commit
hash (don't forget to remove the comma on the line above) temporarily (we'll add it back later)snap
directorysnapcraft.yaml
and update the source-tag
Commit everything to git.
Now go to github and do the release.
After the release is done get the hash value for the commit for the new release tag and then add back the commit
line in com.toolstack.Folio.json
. Commit it back to git as well.
Two actions should have been kicked off on the github release, one to build the flatpak and the other to build the snap. These will take a few minutes to complete, but once they do, go to each one and download the built assets.
You will need to build the AppImage manually, follow the instructions above on how to do that and retrieve the generated Folio-x86_64.AppImage file.
Extract both zips that you downloaded and rename the resulting flatpak/snap/AppImage to "Folio-YY.XX[-platform].[flatpak/snap/AppImage]".
Go back to the release and attach these files to the release assets.
Now do the releases on Flathub and Snapcraft.
https://github.com/flathub/com.toolstack.Folio.git
com.toolstack.Folio.json
and update both the tag
and commit
lines to reflect the new release as well as any other changes since the last release (ie. runtime version, etc.)snapcraft login
snapcraft upload --release=stable folio_YY.##_amd64.snap
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:
./generate-POT-file.sh
Folio supports linking to other notes via the standard markdown link syntax, with the url being a relative path to another note. For example, if you want to link to a note called "My big list of links" in the same notebook, then any of the following will work:
[my link](file://./My big list of links)
[my link](./My big list of links)
[my link](./My big list of links.md)
If you want to link to another notebook called "Junk links", you can use any of the following formats:
[my link](file://../Junk links/My big list of links)
[my link](../Junk links/My big list of links)
[my link](../Junk links/My big list of links.md)
Nextcloud notes uses markdown files to store it's information in and has an API to access these, however Folio does not support the API, but can still integrate with Nextcloud notes.
You have two options, either connect with WebDav and expose the notes directory as a filesystem or use the Nextcloud desktop client to synchronize the notes directory to your desktop.
In either case you can then go into Folio's preferences and change the storage location to the Nextcloud Notes folder. You might want to unhide the trash folder, otherwise you'll see a ".trash" folder in your Nextcloud Notes on other clients (unhiding renames it to "Trash").
You may also want to change the trash folder's location to somewhere else on the file system to avoid synchronizing it back to Nextcloud.
There are a few cavitates when using Folio with Nextcloud notes:
Unfortunately Paper is out of date and the developer does not have the time/interest to maintain it any more.
The primary focus of my fork is getting everything up to date and supported for the long term.
A secondary focus is feature additions. Some new features that have already been added are:
You can see what's planned via the issue tracker at GitHub.
Folio is not a replacement for applications like OneNote or other advanced note taking apps, as such, there are some features that will never be added to Folio, like:
Basically anything that tries to make Folio into something other than a markdown editor.
Of course if someone created a PR that added one or more of those things, I'd be open to reviewing it and see if the implementation fits well or not.
You can use Folio with cloud storage providers like Google Drive, however there are a few things to keep in mind:
Cloud providers that do not integrate directly with GNOME or have alternatives to GNOME's integration (like Nextcloud) should work and may not have the above mentioned issues.
In general, if your cloud provider has a sync client, that copies your data to your local disk and keeps it up to date, you will have a better experience with Folio than a client that tries to use the cloud directly.