studystreak 0.1.1

A terminal study streak tracker with Chrome focus sync.

StudyStreak

StudyStreak is a terminal study tracker that helps students build consistent study habits. It includes streak tracking, session logging, timetable planning, focus mode, achievements, leaderboard sync, and a Chrome companion extension for focus-quality tracking.

Install

StudyStreak requires Python 3.10 or newer.

pip install studystreak

Open the app:

studystreak ui

Features

• Track daily study streaks
• Log study sessions by subject
• Plan timetable sessions
• Use Focus Mode to time study sessions
• Track Chrome focus quality with the companion extension
• Sync subjects, timetable sessions, streaks, and focus-quality summaries
• View leaderboard streak rankings
• Unlock achievements
• Export and import focus-quality data as an offline fallback

Commands

studystreak ui
studystreak log maths 30
studystreak today
studystreak streak
studystreak create-user alex
studystreak login alex
studystreak logout
studystreak users

Chrome Extension

The Chrome extension adds browser focus tracking. It can:

• Start and stop focus sessions
• Detect focused, distracted, and idle time
• Sync focus-quality summaries to the app
• Show today's timetable sessions
• Send timetable reminders
• Optionally enable Strict Focus to redirect distracting sites

To use it locally, clone this repository and load the chrome_extension folder as an unpacked extension in Chrome.

Cloud Sync

StudyStreak works locally without sync. Online account sync and leaderboard features require a StudyStreak backend account and server.

If you are running your own backend, set:

STUDYSTREAK_API_URL=https://your-backend-url

Development

Clone the repo:

git clone https://github.com/Chi-ChunL/StudyStreak.git
cd StudyStreak

Install locally:

pip install -e .

Run the app:

studystreak ui

Build the package:

python -m build

Privacy

StudyStreak stores local study data on your machine. Cloud sync only sends data needed for account sync, leaderboard streaks, timetable data, subject websites, and focus-quality summaries.

Status

StudyStreak is in early development. Expect improvements to setup, sync, packaging, and browser support over time.