Skip to content

Latest commit

 

History

History
178 lines (131 loc) · 7.19 KB

README.md

File metadata and controls

178 lines (131 loc) · 7.19 KB
Raw

Joplin - a free and secure notebook application

. . . packaged for the Fedora, Red Hat (IBM), and OpenSUSE families of linux distributions

Joplin is a powerful desktop and mobile application for writing and organizing markdown-formatted documents synced between devices and storeed fully end-to-end encrypted on the local filesystem as well as the cloud. Joplin can manage large numbers of notes and documents organised into notebooks. The notes are searchable, can be copied, tagged and modified either from the applications directly or from your own favorite text or markdown editor.

Notes can be imported from Evernote, to include all associated resources (images, attachments, etc) and all metadata (geo-location, update time, creation time, etc). Notes can, of course, also be imported from any other markdown source.

Mirroring and redundancy between your devices is achieved by a simple, and optionally encrypted, synchronization with the excellent paid-for service Joplin Cloud, or one of the major cloud services including Nextcloud, Dropbox, Onedrive, WebDAV. Or sync to a local or network-accessible file system. Read more here: https://joplinapp.org/help/apps/sync/

More information about Joplin the project can be found at joplinapp.org and at it's GitHub page. I maintain all RPM package development bits here: https://github.com/taw00/joplin-rpm.

I can be messaged at t0dd@protonmail.com or as user t0dd in the Joplin Community Forums.

TL;DR - I want to install Joplin!

Open up a terminal and copy and paste these commands on the commandline of your Fedora Linux workstation or desktop. Note, I assume you are logged in as a user that has "sudo" rights.

Fedora and RHEL/CentOS users . . .

Prep the repository . . .

sudo dnf install -y dnf-plugins-core distribution-gpg-keys
sudo dnf copr enable taw/joplin

Install Joplin . . .

sudo dnf install -y joplin

OpenSUSE users . . .

Prep the repository . . .

# Repository setup for OpenSUSE Leap 15.3
sudo wget https://copr.fedorainfracloud.org/coprs/taw/joplin/repo/opensuse-leap-15.3/taw-joplin-opensuse-leap-15.3.repo -O /etc/zypp/repos.d/taw-joplin-opensuse-leap-15.3.repo
sudo zypper refresh

# Repository setup for OpenSUSE Tumbleweed
sudo wget https://copr.fedorainfracloud.org/coprs/taw/joplin/repo/opensuse-tumbleweed/taw-joplin-opensuse-tumbleweed.repo -O /etc/zypp/repos.d/taw-joplin-opensuse-tumbleweed.repo
sudo zypper refresh

Install Joplin . . .

# Install Joplin on OpenSUSE
sudo zypper install joplin

All users . . .

Once installed, find Joplin in your desktop menus or do a normal application search. Then run it. Visit joplinapp.org for documentation and help.

Useful tidbit:

  • application state is maintained at ~/.config/Joplin
  • all Joplin documents and such are mirror locally at ~/.config/joplin-desktop

(corner case oddball issue)
EXPIRED GPG KEY?

If you get complaints about an expired GPG KEY for the COPR repo after dnf downloads the joplin RPM, do this …

  1. Find the actual COPR key being used: rpm -q --qf "%{NAME}-%{VERSION}-%{RELEASE}\t%{SUMMARY}\n" gpg-pubkey | grep joplin
  2. Remove the GPG key: sudo rpm -e gpg-pubkey-XXXXXXXX-XXXXXXXX (replacing the gpg-pubkey-* with the numbers from step 1).
  3. Re-install or upgrade: sudo dnf upgrade joplin -y or sudo dnf install joplin -y

What's in this Github repository?

This repository provides and maintains source packages that can be built to run on Fedora Linux 29+ and EL8 (testing-only) on x86_64. Binary (fully functional) application packages based on these source packages are available elsewhere (in the Fedora Project's COPR repositories) (see below) and make Joplin relatively easy to install and maintain.

In order to use this application, you only need to download and install the joplin application (via the COPR repos). It will, by default, only store your notes and documents locally. And unencrypted. It is highly recommended that (a) you secure your notes with encryption, and (b) configure the application to sync to the cloud (Dropbox, Nextcloud, etc).

Why github for this sort of thing?

I build RPM packages for various projects. Constructing and maintaining source RPMs is very much like any other software or documentation effort. That effort for Joplin is maintained with source-control via github. Binaries are provided here. But you don't need to know a whole lot about Fedora's COPR build environment to install and use these RPMs. Just follow the "TL;DR" instructions below to install Joplin.

If you are technically savvy, you can build your own binary packages from the source RPMs provided in this github repository. All src.rpm files (found here in Github) will be signed with my general-purpose GPG key found here: https://keybase.io/toddwarner/key.asc.

Packages delivered via COPR are signed with a GPG key specific to that repository. COPR enablement as shown elsewhere (TL;DR) will install this key appropriately when necessary.

OS Notes

As of version 2.3.3, the normal build process is breaking due to some bizarre dependency calling python2 in the build tree. Thus far, after many many hours attempting to work around the issue, I have not been successful in mitigating the problem. For the foreseeable future, I will be packaging upstream AppImage binaries until this is resolved.

As of version 2.4.z, I will be moving builds away from EL8 proper and to CentOS Stream only.

Comments? Suggestions?

Open an issue here, or send me a note via Keybase -- https://keybase.io/toddwarner