tp-note 1.6.4

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. 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. By default TP-Note launches the system file-editor (or any other of your choice, e.g. Typora) after creating a new note.

• Read more in Tp-Note’s user manual

• Download Tp-Note

• Project page: Tp-Note - fast note-taking with templates and filename synchronization

Documentation

User documentation:

• 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.

  Tp-Note user manual - html

  Tp-Note user manual - pdf

• 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.

  Tp-Note manual page - html

  Tp-Note manual page - pdf

• Blogposts about Tp-Note

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.

  API documentation

Source code

Repository:

• Tp-Note on Github

Distribution

Tp-Note Microsoft Windows installer package

• Installer package for Windows:

  tp-note-1.6.4-x86_64.msi

  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):

  x86_64-unknown-linux-gnu/debian/tp-note_1.6.4_amd64.deb

Various binaries for Windows, MacOS and Linux

• Binaries for Ubuntu-Linux 18.04, Windows, MacOS:

  1. Open: Releases - getreu/tp-note

  2. Open the latest release.

  3. Open assets.

  4. Download the packed executable for your operating system.

  5. Installation: see below.

• Executable for Windows:

  • x86_64-pc-windows-gnu/release/tp-note.exe

• Universal Linux binary (compiled with Debian 10 Buster):

  • x86_64-unknown-linux-gnu/release/tp-note

  • The following "musl" version is well suited for headless systems, as it does not require GTK libraries to be installed.

    x86_64-unknown-linux-musl/release/tp-note

• Installable Unix man-page:

  • tp-note.1.gz

• Zipfile with all binaries and documentation:

  • tp-note all

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.6.4-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, you might see one of the following messages:

ERROR: unable to load, parse or write the configuration file
---
Bad TOML data: missing field `version` at line 1 column 1

Note: this error may occur after upgrading Tp-Note due
to some incompatible configuration file changes.

Remedy: backup and delete the configuration file in order
to restart Tp-Note with its default configuration.
---
Additional technical details:
*    Command line parameters:
tp-note
*    Configuration file path:
/home/getreu/.config/tp-note/tp-note.toml

or

ERROR: configuration file version mismatch:
---
Configuration file version: '1.5.2'
Tp-Note version: '1.5.5'
Minimum required configuration file version: '1.5.5'

Remedy: Backup and delete the old config file in
order to restart Tp-Note with its 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 suggest, the solution is to backup and delete the old incompatible configuration file. Next time you start Tp-Note, a new version of this file will be installed at the same location.

There is no need to say, that in case you modified the configuration file, you should backup before delete.

Building

If the above precompiled binaries do not suite you, you can compile Tp-Note yourself.

1. Install Rust, e.g.

   curl https://sh.rustup.rs -sSf | sh
   

2. 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
   

   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