{"id":20326757,"url":"https://github.com/infeeeee/kimai2-cmd-argos","last_synced_at":"2025-05-08T01:30:41.619Z","repository":{"id":118788966,"uuid":"196005413","full_name":"infeeeee/kimai2-cmd-argos","owner":"infeeeee","description":"Argos/Kargos/Bitbar script for Kimai2","archived":true,"fork":false,"pushed_at":"2019-08-04T20:04:00.000Z","size":396,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-20T02:39:30.937Z","etag":null,"topics":["argos","bitbar","kargos","kimai","kimai2","time-tracker"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/infeeeee.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}},"created_at":"2019-07-09T12:36:23.000Z","updated_at":"2024-02-27T15:14:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"8713ae47-fb27-41dc-bdc7-f58ce6b3ba88","html_url":"https://github.com/infeeeee/kimai2-cmd-argos","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infeeeee%2Fkimai2-cmd-argos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infeeeee%2Fkimai2-cmd-argos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infeeeee%2Fkimai2-cmd-argos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/infeeeee%2Fkimai2-cmd-argos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/infeeeee","download_url":"https://codeload.github.com/infeeeee/kimai2-cmd-argos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252981413,"owners_count":21835423,"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":["argos","bitbar","kargos","kimai","kimai2","time-tracker"],"created_at":"2024-11-14T19:45:14.217Z","updated_at":"2025-05-08T01:30:41.604Z","avatar_url":"https://github.com/infeeeee.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kimai2-cmd-argos\n\nArgos/Kargos/Bitbar script for Kimai2. Only useable with [kimai2-cmd](https://github.com/infeeeee/kimai2-cmd)\n\n## Installation\n\n### Prerequisites for all platforms:\n\n- Install [Kimai2](https://www.kimai.org/) on a server, and create an API password\n- Download and setup [kimai2-cmd](https://github.com/infeeeee/kimai2-cmd)\n\n### Argos - Gnome\n\nInstall Argos from Gnome extensions: https://extensions.gnome.org/extension/1176/argos/\n\nLink kimai2-cmd as `kimai` with the following command:\n```\nsudo ln -s /path/to/kimai2-cmd-linux /usr/bin/kimai\n```\nIf you don't do this you have to change the path in kimai2-cmd's settings.ini\n\nDownload the script file to `~/.config/argos`:\n\n```\ncurl https://raw.githubusercontent.com/infeeeee/kimai2-cmd-argos/master/kimai.1r.1m.sh -o ~/.config/argos/kimai.1r.1m.sh\n```\nMake sure it's executable:\n```\nsudo chmod +x ~/.config/argos/kimai.1r.1m.sh\n```\nIt should appear on your top bar. To modify it's location and refresh rate modify the file name according to argos documentation: \nhttps://github.com/p-e-w/argos/\n\n### Kargos - KDE\n\nNot tested yet, it should work, similar to Argos install\n\n### Bitbar - Mac\n\nInstall BitBar: https://getbitbar.com/\n\nSet up the bitbar plugin directory, download the script and move it to the bitbar plugin directory:\n\n```\ncurl https://raw.githubusercontent.com/infeeeee/kimai2-cmd-argos/master/kimai.1r.1m.sh -o kimai.1r.1m.sh\nmv kimai.1r.1m.sh /path/to/plugin/dir/\n```\nMake sure it's executable:\n```\nsudo chmod +x /path/to/plugin/dir/kimai.1r.1m.sh\n```\nCheck the bitbar settings in kimai2-cmd's settings.ini. Add the **full path** to the kimai2-cmd executable:\n```\n[argos_bitbar]\nkimaipath=/path/to/kimai2-cmd-macos\n```\nOptionally, if you linked kimai2-cmd to `/usr/bin` you can use a path like this: `/usr/bin/kimai`\n\n## Usage\n\nIf you click on an active measurement it will be stopped. \n\nIf you click on a recent mesurement it will be restarted.\n\nClick reload to reload\n\n## Screenshots\n\n### Argos - Gnome\n\n![Argos - active measurement](img/screenshot-argos-active.png)\n\n![Argos - recent measurements](img/screenshot-argos-recent.png)\n\n### Bitbar - Mac\n\n![Bitbar - active measurement](img/screenshot-bitbar-active.png)\n\n![Bitbar - recent measurements](img/screenshot-bitbar-recent.png)\n\n## Settings\n\n### Settings in the script\n\nYou can change the path to kimai:\n\n```\n# path to kimai:\nkimaipath=/path/to/kimai2-cmd-macos\n```\n\nYou can change the image by uncommenting th selected line. Default is White icon with alpha\n\nOn mac if you want to use the colored icon you have to change `imagetype` to `imagetype=image`. On linux these setting doesn't do anything.\n\n### Settings in the script filename\n\nThe number before the last dot means the update interval, you can change it to something else if you want, default is `1m` which means 1 minute.\n\nThe value before that is it's location, only works on linux, Bitbar ignores this value. The default is `1r` Means, it's on the right side of the top bar. More info in the argos documentation: https://github.com/p-e-w/argos/\n\n### Settings in kimai2-cmd's settings.ini\n\nYou can find this settings in kimai2-cmd's settings.ini\n\n```\n[argos_bitbar]\nkimaipath=/path/to/kimai2-cmd-macos\nbuttonlength=10\n```\n\n`kimaipath`: On mac you have to use the full path to kimai2-cmd here. On linux you can use alias. The default value on mac is the full path to the executable, on linux it's simply `kimai`\n\n`buttonlength`: The length of the always visible button in characters. Only applies if there is an active measurement. Default is `10`\n\n## Troubleshooting\n\nIf something is not working make sure that kimai2-cmd works. If kimai2-cmd is not working please open an issue there!\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfeeeee%2Fkimai2-cmd-argos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finfeeeee%2Fkimai2-cmd-argos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfeeeee%2Fkimai2-cmd-argos/lists"}