Gamify your life with a command-line productivity tool that helps you track work sessions and maintain motivation through a customizable reward system.
- Timed Work Sessions: Start tracked work sessions with a minimum required duration
- Project Management: Choose from customizable project list and leave notes for your next work session
- Progress Tracking:
- Daily and weekly activity visualization
- Running averages for each day of the week
- High score tracking across multiple time intervals
- Reward System:
- Earn treats for completing individual stints
- Unlock special rewards for reaching time-based milestones
- Track progress towards daily, weekly, and total-time achievement goals
- Clone the repository
- Install required dependencies:
pip install playsound questionary rich- Configure your
data/settings.jsonfile in accordance withdata/settings.example.json - Run the application:
python main.py- Start the application
- Use command
sto begin a new stint - Select or enter your task
- Complete the minimum required time
- Continue working until you're ready to end the stint
- Use other commands to track your progress and view statistics
l- Show activity summary with charts and statisticslw- Display detailed week viewlt- View progress towards treatsll- View recent stint logst- View and redeem available treatss- Start a new stintc- Clear consoleh- Show help menu
The app uses a data/settings.json file to manage:
- Minimum stint duration
- Available projects
- Time of day past which stints won't be tracked:
end_stint_at - Reward definitions including:
- Individual stint rewards
- Cumulative time rewards
- High score interval rewards
- Grace periods for claiming rewards
- Time is represted in the following format: YY:WW:DD:HH:MM:SS
- The timer will add a newline after each update if the terminal window is not wide enough
- Python 3.x
- Required packages: playsound, questionary, rich
MIT License