{"id":19577390,"url":"https://github.com/hangxingliu/vscode-coding-tracker","last_synced_at":"2025-04-09T18:17:01.572Z","repository":{"id":11714745,"uuid":"70340949","full_name":"hangxingliu/vscode-coding-tracker","owner":"hangxingliu","description":":clock10: A coding activities tracker(time, file, type)","archived":false,"fork":false,"pushed_at":"2022-12-10T16:08:50.000Z","size":501,"stargazers_count":178,"open_issues_count":21,"forks_count":36,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-09T18:16:56.466Z","etag":null,"topics":["report","tracker","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hangxingliu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-08T15:38:44.000Z","updated_at":"2025-03-27T14:21:50.000Z","dependencies_parsed_at":"2023-01-13T16:37:50.663Z","dependency_job_id":null,"html_url":"https://github.com/hangxingliu/vscode-coding-tracker","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hangxingliu%2Fvscode-coding-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hangxingliu%2Fvscode-coding-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hangxingliu%2Fvscode-coding-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hangxingliu%2Fvscode-coding-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hangxingliu","download_url":"https://codeload.github.com/hangxingliu/vscode-coding-tracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085323,"owners_count":21045139,"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":["report","tracker","vscode","vscode-extension"],"created_at":"2024-11-11T07:06:11.867Z","updated_at":"2025-04-09T18:17:01.523Z","avatar_url":"https://github.com/hangxingliu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Visual Studio Code Coding Tracker\n\n**A VSCode extension that track your coding activities and generate report about your coding.**   \nYou can know how much time you spent on each projects/files/computers/languages/branchs and total\n by this extension.\n\nSupported languages:\nEnglish, Russian(русский), Spanish(Español),\n Simplified Chinese(简体中文) and Traditional Chinese(繁體中文).\n\nAll part of this extension(included server program, documents) are open-source and hosted on Github.\n\n\u003e Links:  \n\u003e [Server program Github repo](https://github.com/hangxingliu/vscode-coding-tracker-server)   \n\u003e [VSCode extensions marketplace](https://marketplace.visualstudio.com/items?itemName=hangxingliu.vscode-coding-tracker)   \n\n## Screenshot\n\n![screenshots2](https://raw.githubusercontent.com/hangxingliu/vscode-coding-tracker-server/master/screenshots/2.jpg)\n\n## Current Version\n\n### 0.7.0 (Next version)\n\n1. Fix local server launch faild on users who have not install `Node.js` or installed `nvm`.\n\nIf you want use this version now,\n**you can uninstall old version in VSCode, And clone this repository into `$HOME/.vscode/extensions`**\n\n### 0.6.0 (2018/03/25)\n\n1. Upgrade server program (report page) to 0.6.0\n\t- export/download report as CSV\n\t- merge report from different projects\n\t- fix some bug on report page\n\t- more compatible with old browsers and mobile browsers\n2. Optimize for some vscode internal documents. (*Default settings, markdown preview, interactive playground*)\n3. Add Español translations into extension.\n\nmore version information: [CHANGELOG.md](CHANGELOG.md)\n\n## **How To Use (Easy And Common Way)**\n\n**Applicable to people dont want to read below long text and only use VSCode in one computer**\n\n1. Install this extension.\n2. Coding as you did before.\n3. Get your coding report by command **CodingTracker: Show your coding activities report**\n\t- *press `F1` to open VSCode command panel, then search command above and click it*\n\n## How To Use (Fully guide) **TLDR**\n\n\u003e VSCode Coding Tracker actually has two part: extension and server (C/S)\n\u003e\n\u003e And extension use internal server installed in *node_modules* by default.\n\u003e\n\u003e But you could install a server program on you server and use it on VSCode on different computers. \n\u003e\n\u003e Server program repository: [vscode-coding-tracker-server](https://github.com/hangxingliu/vscode-coding-tracker-server)\n\n### Step1. Installing extension to your VSCode\n\nSearch `vscode-coding-tracker` in VSCode extension panel and install it.\n\n### Step2. Install and Launching tracker server in remote server or local\n\n#### Local computer (controlled by VSCode)\n\nYou don't need to do anything.(And **don't** change the configuration `codingTracker.localServerMode` to `false`)\n\nIn this situation, the database files are located in `$HOME/.coding-tracker/`\n\n#### Local computer (controlled by yourself)\n\n0. Set your vscode configuration `codingTracker.localServerMode` to `false`\n1. Open a terminal/command line\n2. Change path to `%HOME%/.vscode/extensions/hangxingliu.vscode-coding-tracker-0.6.0`\n\t- In Windows OS, enter command: `cd %HOME%/.vscode/extensions/hangxingliu.vscode-coding-tracker-0.6.0`\n\t- In Linux/Mac OS, enter command: `cd $HOME/.vscode/extensions/hangxingliu.vscode-coding-tracker-0.6.0`\n3. Execute `npm i`\n4. Launch tracker server by using command: `npm start -- -t ${REPLACE_TO_YOUR_TOKEN}`\n\t- Such as `npm start -- -t test_token`, means your upload token is `test_token`\n\t- And you can get more configurations and descriptions by using command `npm start -- --help`\n\t- Be care! It is necessary to add `--` following to `npm start` to passing following arguments to tracker server\n5. And your tracking data is under `./database` in default.\n\n#### Remote server\n\n0. Set your vscode configuration `codingTracker.localServerMode` to `false`\n1. Login into your remote server\n2. Be sure to install `node` and `npm` environments\n3. Typing command `npm i vscode-coding-tracker-server` (Global install: append ` -g` to the command)\n4. Launch tracker server by using command: `npm start -- -t ${REPLACE_TO_YOUR_TOKEN}`\n5. And your tracking data is under `./database` in default.\n\n### Step 3. Configuring the upload token and your server address in your VSCode\n\nconfigurations:\n\n- `codingTracker.serverURL` (set up such as \"http://localhost:10345\")\n\t- If you use local tracker server and use default config, you can ignore this config.\n\t- Because default value of this config is `http://localhost:10345` \n- `codingTracker.uploadToken` (set up such as \"123456\")\n\t- Setting up this value same as the token you launch your server\n- `codingTracker.computerId` (set up this computer name then you can easy to know which computer you coding more time)\n\t- (Optional config)\n- `codingTracker.localServerMode` (in default is true). Please refer above\n- `codingTracker.moreThinkingTime` (in default is 0 ). More thinking time for tracking\n\t- This config is making for people need more thinking time in coding activity.\n\t- The bigger value you set the longer time you get in report time\n\t- **I don't recommend setting up this value bigger, Because I believe the default think time in extension is nice followed my usage**\n\n### Step 4. See your report\n\nOpen command panel in your VSCode.Then search and click command `CodingTracker: Show your coding activities report`\n\nOr, just open browser and enter `http://${YOUR_SERVER_HOST_NAME}:${PORT}/report/?token=${API_TOKEN}`\n\n- Such as `http://127.0.0.1:10345/report/`\n- Such as `http://mydomain.com:10345/report/?token=myUploadToken`\n\n### More commands:\n\n- `codingTracker.startLocalServer` \n- `codingTracker.stopLocalServer` \n- `codingTracker.showReport`\n\n## Contributing\n\n[CONTRIBUTING.md](CONTRIBUTING.md)\n\n## Author\n\n[LiuYue (hangxingliu)](https://github.com/hangxingliu)\n\n## Contributors\n\n- [Ted Piotrowski (@ted-piotrowski)][ted-piotrowski]\n- [Dolgishev Viktor (@vdolgishev)][vdolgishev]\n\n## Third party codes and resource\n\n- The icon of this extension is from [emojione](http://emojione.com/). This project help me a lot of (bkz I dont know how to use PS and dont have art sense).\n- `lib/thirdPartyCodes/gitPaths.js` is modified from \u003chttps://github.com/DonJayamanne/gitHistoryVSCode/blob/master/src/helpers/gitPaths.ts\u003e\n\n## License\n\n- Extension(excluded icon and third party codes) and server scripts are licensed under [GPL-3.0](LICENSE)\n- Icon of extension is licensed under [CC-BY 4.0](http://emojione.com/licensing/)\n- Third party codes license information in the front of third party code files\n\n[vdolgishev]: https://github.com/vdolgishev\n[ted-piotrowski]: https://github.com/ted-piotrowski\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhangxingliu%2Fvscode-coding-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhangxingliu%2Fvscode-coding-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhangxingliu%2Fvscode-coding-tracker/lists"}