Skip to content
SyomesPublic

About

ManicRead is a ui tool(or app) to display ManicTime's statistics data (especially for GNU/Linux).

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

33 Commits

Folders and files

Repository files navigation

ManicRead

Overview

The Linux version of ManicTime does not render a UI locally — it only provides timeline tracking for each application, ultimately generating a sqlite database file (typically located in ~/.config/manictime/), along with a Screenshots directory for storage.

As of 2025.06.24, only ManicTimeReports.db is used and read as the data source; the backend searches the Screenshots directory to display images. The interface is rendered as a web page, primarily using NiceGUI, with charts rendered via embedded HighCharts.

Features

  • Daily — Track by specific date

  • Period — Track by time range

Usage

Note

ManicTime data files are typically stored in ~/.config/manictime/. If the path has been modified, check your actual location.

Python 3.10+ is recommended.

Clone

git clone https://github.com/Syomes/ManicRead.git

Dependencies

pip install -r requirements.txt

Run

python main.py

This will start a web server at http://127.0.0.1:8080 by default.

License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.

About

ManicRead is a ui tool(or app) to display ManicTime's statistics data (especially for GNU/Linux).

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages