Weekly Commits transforms your GitHub activity into a beautiful visual representation directly in your GNOME Shell top bar. Stay motivated and track your coding consistency at a glance!
- 📊 Visual Contribution Calendar: Seven colorful boxes representing your weekly commit activity
- 🖱️ Interactive Popup: Click to see detailed daily commit counts
- ⚙️ Easy Configuration: Simple GUI preferences for GitHub credentials and settings
- 🔄 Auto-sync: Configurable intervals to keep your data fresh
- 📍 Flexible Positioning: Place the widget anywhere on your top bar
- 14+ Beautiful Themes: GitHub, Dracula, Halloween, Panda, Solarized, and more
- Dual Coloring Modes:
- Opacity-based: Subtle transparency effects
- Grade-based: Distinct color intensities
- Week Start Options: Choose between Monday or Sunday start
- Custom Positioning: Perfect alignment with your workflow
- Visit the GNOME Extensions page
- Click "Install" and follow the browser prompts
- Enable the extension in the GNOME Extensions app
-
Clone the repository:
git clone https://github.com/funinkina/weekly-commits.git
-
Install to extensions directory:
mv weekly-commits ~/.local/share/gnome-shell/extensions/[email protected]
-
Restart GNOME Shell:
- X11: Press
Alt+F2, typer, and pressEnter - Wayland: Log out and log back in
- X11: Press
-
Enable the extension:
gnome-extensions enable [email protected]
Or use the GNOME Extensions app
- GNOME Shell 46, 47, or 48
- Internet connection for GitHub API access
To start tracking your commits, you'll need to configure your GitHub credentials:
- Go to GitHub Personal Access Tokens
- Create a Fine-grained Personal Access Token with:
- Repository Access: "All repositories" or select specific ones
- Permissions: Read access to repository metadata and contents
- Copy the generated token
- Right-click on the Weekly Commits widget in your top bar
- Select "Preferences" or use the GNOME Extensions app
- Enter your:
- GitHub Username: Your GitHub account username
- Personal Access Token: The token you generated in Step 1
- Update Interval: How often to refresh data (default: 1 hour)
- Position: Where to place the widget in the top bar
- Theme: Choose from 14+ beautiful color themes
- Coloring Mode: Opacity-based or grade-based visualization
- Week Start: Monday or Sunday
- Your token is stored locally and only used to fetch your public contribution data
- No data is transmitted to third parties
- The extension only reads your commit history, never modifies anything
Weekly Commits comes with a variety of beautiful themes to match your desktop:
| Theme | Description |
|---|---|
| GitHub | Classic GitHub contribution graph colors |
| Dracula | Popular dark theme with purple accents |
| Halloween | Spooky orange and black theme |
| Panda | Cute panda-inspired green theme |
| Solarized Dark/Light | Popular developer color schemes |
| Blue, Pink, Teal | Vibrant single-color themes |
| Sunny, YlGnBu | Gradient and scientific visualization themes |
# Clone the repository
git clone https://github.com/funinkina/weekly-commits.git
cd weekly-commits
# Install to local extensions directory
make install
# Enable the extension
make enableContributions are welcome! Please:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
- ✅ Settings page for GitHub credentials
- ✅ Automatic data fetching with configurable intervals
- ✅ Customizable top bar positioning
- ✅ Interactive daily commit popup
- ✅ Week start day configuration (Monday/Sunday)
- ✅ Multiple color themes and coloring modes
- 🔄 Customizable commit view thresholds
- 🔄 Internationalization and translations
- 🔄 Support for multiple GitHub accounts
- 🔄 Additional visualization modes
If you find Weekly Commits useful, consider supporting its development:
Extension not showing commits?
- Verify your GitHub username is correct
- Ensure your Personal Access Token has proper permissions
- Check your internet connection
- Look for error messages in
journalctl -fwhile testing
Widget not appearing in top bar?
- Make sure the extension is enabled in GNOME Extensions app
- Try restarting GNOME Shell (
Alt+F2, typer, press Enter on X11) - Check if the extension is compatible with your GNOME Shell version
Need help?
- Open an issue on GitHub
- Check existing issues for solutions
- Provide your GNOME Shell version and error logs
This project exists thanks to the contributions of:
- Aryan Kushwaha (@funinkina) - Original Creator & Lead Developer
- Initial extension concept and implementation
- Core GitHub API integration
- Base UI and functionality
- Project architecture and design decisions
- Aryan Techie (@Aryan-Techie) - Feature Developer & Contributor
- Theme system implementation (14+ color themes)
- Settings page enhancements and instant save functionality
- UI/UX improvements and bug fixes
- About section enhancements
- New Icon design and branding improvements
- Comprehensive documentation overhaul
Want to contribute? Check our Contributing Guidelines and join us!
This project is licensed under the MIT License. See the LICENSE file for details.
- Extension Page: GNOME Extensions
- Source Code: GitHub Repository
- Bug Reports: Issues
- Creator & Developer: Aryan Kushwaha
- Developer: Aryan Techie
Made with ❤️ for the GNOME community
Legal Notice: This project is not affiliated with or endorsed by GitHub, Inc. or the GNOME Foundation. The use of the GitHub logo and name is for informational purposes only and does not imply any endorsement or affiliation with GitHub, Inc. All trademarks and copyrights are the property of their respective owners.