{"id":13557268,"url":"https://github.com/ActivityWatch/aw-watcher-input","last_synced_at":"2025-04-03T11:31:26.616Z","repository":{"id":43829397,"uuid":"315298527","full_name":"ActivityWatch/aw-watcher-input","owner":"ActivityWatch","description":"Track your keypresses and mouse movements with ActivityWatch","archived":false,"fork":false,"pushed_at":"2024-10-17T16:38:32.000Z","size":173,"stargazers_count":109,"open_issues_count":17,"forks_count":20,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-30T00:54:48.150Z","etag":null,"topics":["activitywatch","activitywatch-watcher","input","keyboard-events","mouse-events"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ActivityWatch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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},"funding":{"github":["ActivityWatch"],"open_collective":"activitywatch","liberapay":"ActivityWatch","custom":["https://activitywatch.net/donate/"]}},"created_at":"2020-11-23T11:48:55.000Z","updated_at":"2024-10-21T14:16:16.000Z","dependencies_parsed_at":"2024-10-21T05:10:56.842Z","dependency_job_id":null,"html_url":"https://github.com/ActivityWatch/aw-watcher-input","commit_stats":{"total_commits":30,"total_committers":3,"mean_commits":10.0,"dds":0.09999999999999998,"last_synced_commit":"b6db2763cfbee92c6669ac18e8c4a767392d0810"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-input","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-input/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-input/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-input/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ActivityWatch","download_url":"https://codeload.github.com/ActivityWatch/aw-watcher-input/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246866572,"owners_count":20846591,"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":["activitywatch","activitywatch-watcher","input","keyboard-events","mouse-events"],"created_at":"2024-08-01T12:04:14.974Z","updated_at":"2025-04-03T11:31:26.583Z","avatar_url":"https://github.com/ActivityWatch.png","language":"Python","readme":"aw-watcher-input\n================\n\nTrack your keypresses and mouse movements with [ActivityWatch](https://activitywatch.net).\n\nNOTE: Work in progress, contributions welcome!\n\nNOTE: This does not track *which* keys you press, only that you pressed any key some number of times in a given time span. This is **not a keylogger**, and never will be (due to the massive security and privacy implications).\n\n\n# Build\n\nMake sure you have Python 3.7+ and `poetry` installed, then install with `poetry install`.\n\n\n# Usage\n\nRun `poetry run aw-watcher-input --help` for usage instructions.\n\nWe might eventually create binary builds (like the ones bundled with ActivityWatch for aw-watcher-afk and aw-watcher-window) to make it easier to get this watcher up and running, but it's still a bit too early for that.\n\n\n## Custom visualization\n\nThis watcher ships with an **experimental** custom visualization which needs special configuration. \n\n**NOTE:** This is a work-in-progress. Custom visualizations is an experimental feature with little to no decent documentation, so far.\n\nFirst, you need to build it, which you can do by:\n\n```sh\ncd visualization/\nnpm install -g pug-cli browserify  # might need sudo\nnpm install\nmake build\n```\n\nYou can then configure aw-server or aw-server-rust to host the custom visualization.\n\nTo do so for aw-server, add the following to your config file (with the correct path!):\n\n```toml\n[server.custom_static]\naw-watcher-input = \"/home/user/path/to/aw-watcher-input/visualization/dist\"\n```\n\nFor aw-server-rust, instead add the following to your config file (with the correct path!):\n\n```toml\n[custom_static]\naw-watcher-input = \"/home/user/path/to/aw-watcher-input/visualization/dist\"\n```\n\nYou then need to restart aw-server/aw-server-rust for the changes to take effect.\n\nOnce the server is restarted, you can open the Activity view in the web UI, click \"Edit view\", then \"Add visualization\", then click the cogwheel and select \"Custom visualization\". This will open a popup asking for which visualization, here enter \"aw-watcher-input\".\n\nIt should now work. Click save and you're done!\n\n# Notes\n\nThis was massively inspired by ulogme by @karpathy, here's a screenshot of how it looks:\n\n![screenshot of ulogme](https://karpathy.github.io/assets/ulogme_sv2.jpeg)\n\nThe idea is that we can do the same thing with ActivityWatch, and this watcher is an attempt to incorporate this specific part.\n\nHere's a link to the blog post where he presents it: https://karpathy.github.io/2014/08/03/quantifying-productivity/\n","funding_links":["https://github.com/sponsors/ActivityWatch","https://opencollective.com/activitywatch","https://liberapay.com/ActivityWatch","https://activitywatch.net/donate/"],"categories":["Python","others","Other Watchers :gear:"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FActivityWatch%2Faw-watcher-input","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FActivityWatch%2Faw-watcher-input","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FActivityWatch%2Faw-watcher-input/lists"}