Code Monkey home page Code Monkey logo

track's Introduction

track

"A Minimalistic Activity Tracker for Those Who Live in the Terminal"

s1 s2

track is designed in such a way as to let you spend more time being productive instead of making you spend time fiddling with the program that helps you track your actvities. Configure the program using simple self-explainatory commands, and use the fast and ultra-minimal TUI to start tracking your activities using keyboard shortcuts.

Instructions

  • Clone repository (for now)
    • git clone https://github.com/VoltaireNoir/track.git
  • Make sure "track" is executible
    • chmod +x track
  • Add at least one activity using the command track add [name], the UI won't launch otherwise
  • Dependency: Urwid
    • pip install urwid

Commands and Shortcuts

Example: track log activityName

  • track add activity / track a activity
    • Add new activity to the tracker
  • track del activity / track delete activity
    • Delete existing activity
  • track list
    • List all existing activites in the tracker
  • track sel activity / track select activity
    • Select activity to track using the commandline interface
  • track start
    • Start tracking selected activity
  • track status
    • Show status information of selected activity (active/inactive/log)
  • track stop
    • Stop tracking selected activity
  • track log activity
    • Show logs for the given activity
  • track logs
    • Show all logs for all activities
  • track today activity
    • Show only today's log for given activity
  • track clean activity / track clean all / track clean activity [date/today]
    • Clear log of given activity or all activities
    • Only specific log will be cleared if 'today' or a date is specified after activity name
      • Date format dd-mm-yyyy
  • track map activity key
    • Maps activity to the specified keyboard key (options: "1-0" and "!-)")
  • track keymap
    • Shows current keymap
  • track export
    • Export logs to a csv file in working directory
  • track flush
    • Delete all activities including their logs (cannot be recovered)

Keyboard Shortcuts

  • q Quit
  • s Start/Stop
  • l Show log for selected activity
  • D Delete selected activity
  • c Clear today's log for selected activity
  • C Clear all logs for selected activity
  • r Refresh/restart timer if stuck
  • 1-0, !-) Switch between activities (max 20)

Roadmap / Features to be added

  • Manual log entries
  • Delete specific log entry (by date)
  • Modify order of activites
    • Introduced Custom Key-mapping
  • Set everyday goal and display whether or not the goal has been reached
  • Track activity from the commandline
  • Export logs to CSV
  • Generate graph based on logs (stats)

track's People

Contributors

voltairenoir avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.