Skip to content


Switch branches/tags
title author filename_sync
Tp-Note - Minimalistic note taking: save and edit your clipboard content as a note file
Jens Getreu

Cargo Documentation License

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.


User documentation:

Developer documentation:

Source code



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

Various binaries for Windows, MacOS and Linux

Tp-Note NetBSD

  • An official package is available on NetBSD and other "pkgsrc" supported platforms.

    To install Tp-Note on NetBSD, simply use the native package manager:

    pkgin install tp-note

Other ressources


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 tpnote-latest-x86_64.msi is available. For more information, please consult the Distribution section above and the Installation section in Tp-Note's manual.


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 old configuration file and prompts:

NOTE: unable to load, parse or write the configuration file
        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.

Tp-Note backs up the existing configuration
file and creates a new one with default values.

The configuration file backup is stored in the same directory as the newly created configuration file (cf. Customization section of Tp-Note's man-page).


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

  1. Install Rust, e.g.

    curl -sSf | sh
  2. Download, compile and install Tp-Note:

    Building for Linux

    sudo apt-get install -y xorg-dev libxcb-xfixes0-dev libxcb-shape0-dev libgtk-3-dev
    cargo install tp-note
    sudo cp ~/.cargo/bin/tpnote /usr/local/bin

    In case you experience compilation errors in dependent crates, replace cargo install tp-note with the following:

    cargo install --locked tp-note

    If - under Linux - you need to reduce the binary size and you can do 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 into stderr.

    cargo install --no-default-features --features read-clipboard,viewer,renderer tp-note
    sudo cp ~/.cargo/bin/tpnote /usr/local/bin

    Recommended Linux console and server version

    The full-featured version of Tp-Note depends on GUI libraries like GTK that might not be installable on a headless system. Either download the Musl version x86_64-unknown-linux-musl/release/tpnote or compile Tp-Note without default features:

    cargo install --no-default-features --features renderer tp-note
    sudo cp ~/.cargo/bin/tpnote /usr/local/bin

    Building for Windows

    Build the full featured version with:

    cargo install tp-note

    When building for Windows, it does not make sense to exclude the message-box feature, because - under Windows - it does not rely on the GTK library. Instead, it uses direct Windows-API calls for popping up alert boxes. As these calls have no footprint in binary size or speed, always keep the message-box feature compiled in.

    See also the user manual for a more detailed installation description.

This project follows Semantic Versioning.



  • Jens Getreu


  • Apache 2 licence or MIT licence


Minimalistic note taking: save and edit your clipboard content as a note file (Gitlab mirror)




Unknown and 2 other licenses found

Licenses found






No packages published