title: Tp-Note - fast note-taking with templates and filename synchronization
Tp-Note is a note-taking-tool and a template system - freely available for Windows, MacOS and Linux - that consistently synchronizes the note’s meta-data with its filename. If you like to keep your notes next to your files and you care about expressive filenames, then Tp-Note might be the tool of your choice. Tp-Note collects various information about its environment and the clipboard and stores them in variables. New notes are created by filling these variables in predefined and customizable Tera-templates. TP-Note's default templates are written in Markdown and can be easily adapted to any other markup language if needed. After creating a new note, TP-Note launches the system file editor (or any other of your choice, e.g. MarkText or Typora) and connects the default web browser to Tp-Note's internal Markdown/RestructuredText renderer and web server.
-
Read more in Tp-Note’s user manual
-
Project page: Tp-Note - fast note-taking with templates and filename synchronization
Documentation
User documentation:
-
Introductory video
-
Project page:
Tp-Note's project page, which you are reading right now, lists where you can download Tp-Note and gives an overview of Tp-Note's resources and documentation.
-
User manual:
The user manual showcases how to best use use Tp-Note and how to integrate it with you file manager.
-
Unix man-page:
The Unix man-page is Tp-Note's technical reference. Here you learn how to customize Tp-Note's templates and how to change its default settings.
Developer documentation:
-
API documentation
Tp-Note's program code documentation targets mainly software developers. The advanced user may consult the Tp-Note's config module documentation which explains the default templates and setting. Many of them can be customized through Tp-Note's configuration file.
Source code
Repository:
Distribution
Tp-Note Microsoft Windows installer package
-
Installer package for Windows:
As this early version of the Windows installer is not signed yet, Windows will show the error message “Windows protected your PC”. As a work-around, when you click on the link “More info”, a ”Run anyway” button will appear allowing you to continue the installation process. In general, regardless of where a program comes from, I recommend checking every installable file with VirusTotal.
Tp-Note Debian/Ubuntu installer package
-
Package compiled for Debian 10+ (Buster):
Various binaries for Windows, MacOS and Linux
-
Binaries for Ubuntu-Linux 18.04, Windows, MacOS:
-
Open the latest release.
-
Open assets.
-
Download the packed executable for your operating system.
-
Installation: see below.
-
Executable for Windows:
-
Universal Linux binary (compiled with Debian 10 Buster):
-
The following "musl" version is well suited for headless systems, as it does not require GTK libraries to be installed.
-
Installable Unix man-page:
-
Zipfile with all binaries and documentation:
Installation
Depending on the availability of installer packages for your operating system, the installation process is more or less automated. For Windows users the fully automated installation package tp-note-1.8.9-x86_64.msi is available. For more information, please consult the Distribution section above and the Installation section in Tp-Note's manual.
Upgrading
While upgrading Tp-Note, new features may cause a change in Tp-Notes's configuration file structure. In order not to loose the changes you made in this file, the installer does not replace it automatically with a new version. Instead, Tp-Note renames the erroneous configuration file and prompts:
NOTE: configuration file version mismatch:
---
Configuration file version: '1.7.2'
Tp-Note version: '1.7.4'
Minimum required configuration file version: '1.7.4'
For now, Tp-Note backs up the existing configuration
file and next time it starts, it will create a new one
with default values.
---
Additional technical details:
* Command line parameters:
tp-note
* Configuration file path:
/home/getreu/.config/tp-note/tp-note.toml
or
NOTE: unable to load, parse or write the configuration file
---
Reason:
Bad TOML data: missing field `extension_default` at line 1 column 1!
Note: this error may occur after upgrading Tp-Note due
to some incompatible configuration file changes.
For now, Tp-Note backs up the existing configuration
file and next time it starts, it will create a new one
with default values.
---
Additional technical details:
* Command line parameters:
tp-note
* Configuration file path:
/home/getreu/.config/tp-note/tp-note.toml
As the above error messages suggests, all you need to do is to restart Tp-Note in order to create a new updated configuration file.
Building
If the above precompiled binaries do not suite you, you can compile Tp-Note yourself.
-
Install Rust, e.g.
curl https://sh.rustup.rs -sSf | sh
-
Download, compile and install Tp-Note:
sudo apt-get install -y xorg-dev libxcb-xfixes0-dev libxcb-shape0-dev libgtk-3-dev cargo install tp-note sudo cp ~/.cargo/bin/tp-note /usr/local/bin
If you can without error message popup boxes (for example on a headless system),
no GTK is required. In this case all error messages are dumped on the console
from where you started Tp-Note in stderr
.
cargo install --no-default-features tp-note
sudo cp ~/.cargo/bin/tp-note /usr/local/bin
See also the user manual for a detailed installation description.
This project follows Semantic Versioning.
About
Author:
- Jens Getreu
Copyright:
- Apache 2 licence or MIT licence