{"id":15067309,"url":"https://github.com/flakas/latte","last_synced_at":"2025-07-24T11:02:13.290Z","repository":{"id":3001584,"uuid":"4019570","full_name":"flakas/Latte","owner":"flakas","description":"Automatic time tracker for Linux","archived":false,"fork":false,"pushed_at":"2021-06-14T19:39:59.000Z","size":165,"stargazers_count":29,"open_issues_count":5,"forks_count":4,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-04-27T07:00:20.865Z","etag":null,"topics":["linux","python","time-tracker"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flakas.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-04-13T19:39:36.000Z","updated_at":"2024-04-22T17:30:53.000Z","dependencies_parsed_at":"2022-09-21T08:02:22.446Z","dependency_job_id":null,"html_url":"https://github.com/flakas/Latte","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flakas%2FLatte","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flakas%2FLatte/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flakas%2FLatte/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flakas%2FLatte/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flakas","download_url":"https://codeload.github.com/flakas/Latte/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248229491,"owners_count":21068909,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","python","time-tracker"],"created_at":"2024-09-25T01:19:33.636Z","updated_at":"2025-04-10T13:54:55.343Z","avatar_url":"https://github.com/flakas.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Latte - Automatic Time Tracker for Linux\n====================================\n\nStable: [![Build Status](https://secure.travis-ci.org/flakas/Latte.png?branch=master)](http://travis-ci.org/flakas/Latte)\nDevelopment: [![Build Status](https://secure.travis-ci.org/flakas/Latte.png?branch=development)](http://travis-ci.org/flakas/Latte)\n\nDeveloping\n----------\n\n```\ngit clone git://github.com/flakas/Latte.git\ncd Latte\npython setup.py clean develop\n```\n\nInstalling and upgrading\n-----------------------\n\nInstall (upgrade) from the latest source:\n\n```\ngit clone git://github.com/flakas/Latte.git\ncd Latte\npython setup.py install\n```\n\n*OR*\n\nInstall via PIP (Python Package Index):\n\n```\npip install latte\n```\n\nUpgrade via PIP:\n\n```\npip install latte --upgrade\n```\n\nConfiguration\n-------------\n\nConfiguration files are saved in `~/.config/latte` folder.\n\nStatistics files are stored in `~/.config/latte` folder (configurable)\n\nUsage\n-----\n\nRun the binary script either in foreground:\n\n`latte run`\n\nor in the background:\n`latte run --silent \u0026`\n\n### Stats\n\nTo analyze log data you can use the built in analyzer:\n\nSyntax: `latte stats {windows,apps,tags} [OPTIONS]`\n\n- `latte stats windows` to analyze log data from past 24 hours by window title\n- `latte stats -h` to print an help message\n\nTime options:\n\n- `--time-all` to analyze all known log data\n- `--time-seconds S` to analyze log data created in last S seconds\n- `--time-days D` to analyze log data created in last D days\n- `--time-weeks W` to analyze log data created in last W weeks\n- `--time-months M` to analyze log data created in last M months\n\nBy default `latte stats` will analyze logs created in past 24 hours.\n\nDisplaying:\n\n- `--display-all` Display all found entries from the chosen time interval\n- `--display-limit N` Display up to N top entries\n- `--display-time SECONDS` Displays entries that have the accumulated time greater than SECONDS\n\nTags:\n\n- `--tags` show stats for the comma-separated tag names\n\n### Tagging\n\nLatte can tag logs with custom tags for easier grouping and analytics.\n\nAdd tags:\n- `latte tags add \u003cname\u003e [--window-title=\u003cregex\u003e] [--window-class=\u003cregex\u003e] [--window-instance=\u003cregex\u003e] [--tag=\u003cregex\u003e]`\n- Filtering is based on Python's regular expressions using case-insensitive values;\n- Window title, class, instance and tag filters are optional. All specified filters must match for the tag to be assigned.\n\nDelete tags:\n- `latte tags delete \u003cname\u003e`\n\nShow all tags:\n- `latte tags show`\n\nForcibly retag all logs:\n- `latte tags retag`\n\nDependencies\n--------\n\nThis application requires:\n\n- Python 3\n- `xprop` to detect active window title for log tracking (`sudo apt-get install x11-utils`)\n\nThese dependencies are optional, but without them some functionality will not work:\n\n- `libX11.so` and `libXss.so` to detect whether user is inactive (packages `libx11-dev` and `libxss-dev`, `sudo apt-get install libx11-dev libxss-dev`)\n\nGoal\n----\n\nTo build an Automatic Time Tracker for Linux that:\n\n- keeps track of windows where the user spends time\n- is aware if the user is active or not\n- collects information for personal analysis and statistics\n- can classify activities based on user defined rules\n- ignores unwanted and sensitive information\n\nAll without any human intervention (except for the initial set up).\n\nLicense\n-------\n\nMIT license, check LICENSE.txt\n\nContributors\n------------\n\nSpecial thanks to [contributors](https://github.com/flakas/Latte/graphs/contributors).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflakas%2Flatte","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflakas%2Flatte","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflakas%2Flatte/lists"}