# chronoflask

**Repository Path**: mirrors_kmbn/chronoflask

## Basic Information

- **Project Name**: chronoflask
- **Description**: A minimalist diary/journal application made with Python 3, Flask, and TinyDB
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chronoflask
A minimalist diary/journal application made with Python 3, Flask, and TinyDB and inspired by Warren Ellis's Chronofile Minimal and Buckminster Fuller's Dymaxion Chronofile.
Add new entries (with or witout hashtags) in a single input field. Each entry is stored with a UTC timestamp.

View recent entries (in reverse chronological order), view all entries for a single day (in chronological order), view a single entry, view all entries associated with a tag, and view a list of tags.

Chronoflask is private by default. It's made for Python 3, but it should work with Python 2.

## Setup
1. `cd path/to/chronoflask`
2. Optional: set up a virtual environment using virtualenv.
3. Install the required packages: `pip install -r requirements.txt`
4. Set the secret key for session encryption: `export SECRET_KEY=<your_secret_key_here>` (if you're just testing, the length of the string doesn't matter).
5. Enable `export DEBUG=1` or disable `export DEBUG=0` debug mode for the built-in server (enabling debugging is recommended for testing; if you plan to run the app on a production server, though, debugging should be disabled).
6. Optional: in order to enable password reset emails, you'll need to export the following: `export MAIL_SERVER=<your.email.server>`, `export MAIL_USERNAME=<your@email.username>` and `export MAIL_PASSWORD=<your_password>`. If you don't do this, the app will crash if you try to reset your password.
7. `python run.py`.

## Usage
After completing the setup steps, open a browser and navigate to `http://localhost:5000/`. The first time you run the app you'l need to register; the current version of the app is intended to be single-user, so it is only possible to create one account.

Use the entry form to post brief notes, thoughts, observations, etc.

Any `#hashtags` in the entry will be detected and added to a list of tags for that entry. Any `#hashtags` at the end of the entry will will be stripped from the entry text to improve presentation (they'll be added to the tag list beforehand, though).

You can change the name of the chronofile and/or author in the `Admin` section. You can also change your email address and/or password there.