{"id":51728144,"url":"https://github.com/krishnakanthb13/github-meter","last_synced_at":"2026-07-17T22:41:18.266Z","repository":{"id":371118597,"uuid":"1275456325","full_name":"krishnakanthb13/github-meter","owner":"krishnakanthb13","description":"Floating desktop widget displaying your GitHub contribution graph in Sallar's poster style. Built with Python stdlib (urllib, ThreadingHTTPServer) — no Selenium or Flask. Features HTTP-based fetching with retry/backoff, 9 color themes, year cycling, persistent caching, and one-click profile access.","archived":false,"fork":false,"pushed_at":"2026-07-13T13:34:48.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-13T14:10:09.727Z","etag":null,"topics":["cache","contributions","desktop-widget","github","http-server","python","sallar","theme","urllib"],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/krishnakanthb13.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":"2026-06-20T17:59:29.000Z","updated_at":"2026-07-13T13:35:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/krishnakanthb13/github-meter","commit_stats":null,"previous_names":["krishnakanthb13/github-meter"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/krishnakanthb13/github-meter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krishnakanthb13%2Fgithub-meter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krishnakanthb13%2Fgithub-meter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krishnakanthb13%2Fgithub-meter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krishnakanthb13%2Fgithub-meter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/krishnakanthb13","download_url":"https://codeload.github.com/krishnakanthb13/github-meter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krishnakanthb13%2Fgithub-meter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35598364,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-17T02:00:06.162Z","response_time":116,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cache","contributions","desktop-widget","github","http-server","python","sallar","theme","urllib"],"created_at":"2026-07-17T22:41:17.618Z","updated_at":"2026-07-17T22:41:18.254Z","avatar_url":"https://github.com/krishnakanthb13.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Contribution Meter 📊\n\nA beautiful floating desktop widget that displays your GitHub contribution graph, styled in the signature poster layout popularized by **Sallar Kaboli**. It fetches live GitHub calendar HTML via HTTP requests (no browser automation) and serves it locally to a customized border-less window.\n\nBased on the architecture of the **Rhyming Clock**.\n\n## Features\n\n- **HTTP-Based Fetching**: Fetches your live contribution calendar using Python's built-in `urllib` — no Selenium or browser automation required.\n- **Sallar Poster Aesthetic**: Redesigned to mimic Sallar's contribution cards, displaying month and weekday labels cleanly.\n- **Dynamic Year Navigation**: Supports navigating and loading calendar history dynamically from a year cycler in the UI (current year back to 2015).\n- **Persistent Data Folder**: Stores yearly contribution charts in a dedicated `data/` directory to facilitate instant local swapping between fetched years.\n- **Color Theme Selection**: Switch dynamically between 9 color themes: Dracula, Classic Green, Obsidian, Halloween, Violet, Cyberpunk, Arctic, Sakura, and Paper.\n- **Interactive Tooltips**: Preserves contribution count and date details when hovering over grid blocks.\n- **Clickable Profile Info**: Clicking on your avatar, username, or details opens your live GitHub profile in a new window/tab in your default browser.\n- **Floating Window Mode**: Launches Chrome/Edge in `--app` mode without window borders, address bar, or tabs, docked in the bottom-right corner of your desktop.\n\n## Prerequisites\n\n- **Python 3.8+**\n- **Google Chrome** or **Microsoft Edge**\n\n## Setup\n\n1. Clone the repository and install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n2. Copy `.env.example` to `.env` and set your GitHub profile URL:\n   ```env\n   GITHUB_PROFILE=https://github.com/your-username-here\n   ```\n\n## Running the App\n\n### Windows\nDouble-click the **`github-meter.bat`** script.\n\n### macOS / Linux\n```bash\nchmod +x github-meter.sh\n./github-meter.sh\n```\n\nBoth launchers will:\n1. Start the backend API server (`server.py`) in the background.\n2. Spin up Chrome/Edge in app mode as a floating window.\n3. Automatically load the contribution graph.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrishnakanthb13%2Fgithub-meter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkrishnakanthb13%2Fgithub-meter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrishnakanthb13%2Fgithub-meter/lists"}