Skip to main content

gthnk is a personal knowledge management system

Project description

gthnk is a personal knowledge management system. Capture your ideas using plain old text files. Make a journal that lasts 100 years.

Python Package Documentation Status Build Status Coverage Status Github Project

Overview

  • gthnk presents a journal consisting of many entries.

  • Entries are created using plain old text files, which gthnk imports once per day.

  • Any text editor can be used to add information to gthnk.

  • Entries are searchable using the embedded gthnk server, which can be accessed with a browser.

  • Plain-text enables backup/restore via hardcopy (e.g. paper) for long-term archival.

The easiest way to run gthnk is with Docker. gthnk also installs on Windows, Linux, and MacOS systems with Python 3.5+. See the Installation document for more details.

Quick Start

Use Docker to run gthnk with all files stored locally in ~/.gthnk.

docker run -d --rm \
    --name gthnk-server \
    -p 1620:1620 \
    -e TZ=America/Toronto \
    -v ~/.gthnk:/home/gthnk/.gthnk \
    iandennismiller/gthnk

The default text file where you will record journal entries is ~/.gthnk/journal.txt.

Open journal.txt with a text editor to add new journal entries.

Open http://localhost:1620 to access the user interface.

Journal Entries

Use the journal by editing journal.txt with a text editor. First, insert a date marker YYYY-MM-DD and a blank line to start a new journal day. Then, insert a time marker HHMM and a blank line to start a journal entry.

2020-07-04

0804

This is a simple journal entry.

0805

And this is a separate entry, a minute later.

Those two delimiters - date and time followed by a blank line - are all there is to the gthnk journal file format. The rest is Markdown.

You can add multiple entries per day - and multiple days in a single journal - by inserting date and time markers as you work.

Documentation

http://docs.gthnk.com

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gthnk-0.7.0.tar.gz (5.6 MB view hashes)

Uploaded Source

Built Distribution

gthnk-0.7.0-py3-none-any.whl (5.7 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page