{"id":31608608,"url":"https://github.com/probeldev/niri-screen-time","last_synced_at":"2026-01-12T15:28:00.079Z","repository":{"id":294502184,"uuid":"986978647","full_name":"probeldev/niri-screen-time","owner":"probeldev","description":"Niri Screen Time","archived":false,"fork":false,"pushed_at":"2025-11-22T07:25:08.000Z","size":12869,"stargazers_count":18,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-22T09:11:33.002Z","etag":null,"topics":["hyprland","linux","macos","niri","screentime"],"latest_commit_sha":null,"homepage":"","language":"Go","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/probeldev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-20T11:55:39.000Z","updated_at":"2025-11-22T07:25:11.000Z","dependencies_parsed_at":"2025-07-10T05:35:02.697Z","dependency_job_id":"31fcbb18-929f-4018-a2ff-d99611a3e155","html_url":"https://github.com/probeldev/niri-screen-time","commit_stats":null,"previous_names":["probeldev/niri-screen-time"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/probeldev/niri-screen-time","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/probeldev%2Fniri-screen-time","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/probeldev%2Fniri-screen-time/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/probeldev%2Fniri-screen-time/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/probeldev%2Fniri-screen-time/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/probeldev","download_url":"https://codeload.github.com/probeldev/niri-screen-time/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/probeldev%2Fniri-screen-time/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28340752,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["hyprland","linux","macos","niri","screentime"],"created_at":"2025-10-06T08:07:52.891Z","updated_at":"2026-01-12T15:28:00.073Z","avatar_url":"https://github.com/probeldev.png","language":"Go","funding_links":[],"categories":["Tools"],"sub_categories":["Miscellaneous","Locking, Idle, Clipboard and Login"],"readme":"# Niri Screen Time\nA utility that tracks how much time was spent on applications by their class and its title.\n\n![Report Example](https://github.com/probeldev/niri-screen-time/blob/main/screenshots/report.png?raw=true)\n## Supported OS\n### MacOs\n- AeroSpace\n- Default windows manager\n### Linux\nSupported Wayland Compositors:\n- Niri\n- Hyprland\n## Installation\n\n### go\n```bash\ngo install github.com/probeldev/niri-screen-time@latest\n```\n\u003e [!NOTE]  \n\u003e If you get an error claiming that `niri-screen-time` cannot be found or that it is not defined, you\n\u003e may need to add `~/go/bin` to your $[PATH](https://jvns.ca/blog/2025/02/13/how-to-add-a-directory-to-your-path/).\n\n### [aur](https://aur.archlinux.org/packages/niri-screen-time-git) (unofficial)\n\n```bash\nyay -S niri-screen-time-git\n```\n\n### nix \n\n```bash \nnix profile install github:probeldev/niri-screen-time\n```\n\u003e [!NOTE]\n\u003e This is an imperative way of installing, and it is not preferred on Nix.\n\u003e You should define it in your Nix configuration instead.\n## Usage\n\n### Daemon\n\nDaemon — a background service that collects data on application usage time (requires adding to startup for proper operation).\n\nStart the daemon:\n\n```bash\nniri-screen-time -daemon \n```\n\nAdd to startup for MacOs\n\n```bash\nniri-screen-time -autostart enable\n```\n\n### Report \n\n(without key)\n\n```bash\nniri-screen-time \n```\n\nView data from a selected date until today:\n  \n```bash\nniri-screen-time -from=2023-10-20\n```\n\nView data within a date range:\n\n```bash\nniri-screen-time -from=2023-10-01 -to=2023-10-31 \n\n```\n\n\n#### Subroutine and Website Configuration\n\nTo track specific websites or console commands within applications, use the configuration file:\n\n**Supported formats:** YAML (.yaml, .yml) or JSON (.json)\n**Location:**\n`~/.config/niri-screen-time/subprograms.{yaml,yml,json}`\n*Priority order: .yaml → .yml → .json*\n\n##### Configuration Format\n**YAML:**\n```yaml\n- app_ids:\n    - application_identi1\n    - application_identi2\n  title_list:\n    - partial_window_title1\n    - partial_window_title2\n  alias: display_name\n```\n\n**JSON:**\n```json\n[\n  {\n    \"app_ids\": [\n        \"application_identi1\",\n        \"application_identi2\"\n    ],\n    \"title_list\": [\n        \"partial_window_title1\",\n        \"partial_window_title2\"\n    ],\n    \"alias\": \"display_name\"\n  }\n]\n```\n\n##### Configuration Examples\n\nFor terminal commands:\n\n**YAML:**\n```yaml\n- app_ids:\n    - com.mitchellh.ghostty\n  title_list:\n    - \"NeoVim: ~/script/\"\n    - \"NeoVim: ~/.config\"\n  alias: \"NeoVim: edit configs\"\n```\n\n**JSON:**\n```json\n{\n    \"app_ids\": [\n        \"com.mitchellh.ghostty\"\n    ],\n    \"title_list\": [\n        \"NeoVim: ~/script/\",\n        \"NeoVim: ~/.config\"\n    ],\n    \"alias\": \"NeoVim: edit configs\"\n}\n```\n\nFor websites in browser:\n\n**YAML:**\n```yaml\n- app_ids:\n    - zen\n    - app.zen_browser.zen\n  title_list:\n    - Monkeytype\n  alias: Monkeytype\n```\n\n**JSON:**\n```json\n{\n    \"app_ids\": [\n        \"zen\",\n        \"app.zen_browser.zen\"\n    ],\n    \"title_list\":[\n        \"Monkeytype\"\n    ],\n    \"alias\": \"Monkeytype\"\n}\n```\n\nJust alias:\n\n**YAML:**\n```yaml\n- app_ids:\n    - org.gnome.Nautilus\n  title_list: []\n  alias: Nautilus\n```\n\n**JSON:**\n```json\n{\n    \"app_ids\": [\n        \"org.gnome.Nautilus\"\n    ],\n    \"title_list\": [ ],\n    \"alias\": \"Nautilus\"\n}\n```\n\n\n### Details\n\nThis mod adds detailed per-application stats.\n\n```bash\nniri-screen-time -details -appid=\"org.telegram.desktop\" -title=\"\" -from='2025-01-20' -to='2025-08-20' -limit=20 -onlytex\nt\n\n```\n\n## License  \nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprobeldev%2Fniri-screen-time","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprobeldev%2Fniri-screen-time","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprobeldev%2Fniri-screen-time/lists"}