This is a program I created in my free time to help interface with my Google Sheet for tracking all my game playtime across various platforms. It’s a personal project that I wanted to share with others on GitHub.
Important Note: This script is designed to work specifically with my custom Google Sheet. In order for it to function properly, you will need to use the exact same sheet. You can view and make a copy of my Google Sheet here.
- Easily log and track playtime for different video games.
- Choice of using a terminal interface or a simple web interface.
- Automatically formats Google Sheets for better organization and readability.
- Supports multiple gaming platforms and allows for custom date entries.
- Impliment a way to type a game name and then hit a start session and end session button, eliminating the need to manually enter times, and allowing users to let it track sessions more easily
To get started with the Game Session Manager, you can use it in two ways:
-
Clone the repository:
Download Source Go to the
releases
tab to easily find the latest stable, beta, or alpha release. There you can download and extract the.zip
file to get the repoUse Fully Compiled File Additionally, you can download the
GSMFull.py
file. -
Install the required libraries:
Make sure you have Python 3.x installed. Then, install the necessary libraries using pip:
pip install gspread oauth2client Flask PyQt5
-
Set up Google Sheets API:
- Follow this guide to create a project and enable the Google Sheets API.
- Download your
credentials.json
file and place it in the project directory. - Create a text file named
sheetid.txt
and add the Google Sheet ID from your sheet (the part of the URL after/d/
) Should look like this:1cYQ8B-lnzHLaO32mFZJTweRy8vqjr0Wm2kmcHEcFP8A
.
To run the application, you can choose between a terminal interface or a web interface. Additionally, you can use a desktop shortcut with the Launcher to easily choose between versions.
To launch the terminal version:
python gamesessionmanager.py
To launch the web version directly:
python gamesessionmanager.py --web
To use the launcher:
python gamesessionmanager.py --launcher
or create a desktop shortcut with the same code (including the directory the file is located in, of course).
While this is primarily a personal project, I welcome any feedback or suggestions! If you have ideas for improvements or features, feel free to fork the repository and submit a pull request.
- Fork the repository.
- Create your feature branch:
git checkout -b feature/AmazingFeature
- Commit your changes:
git commit -m 'Add some AmazingFeature'
- Push to the branch:
git push origin feature/AmazingFeature
- Open a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
If you have any questions or just want to chat about the project, feel free to reach out:
- Name: ZcraftElite
- GitHub: zcraftelite9495
- Email: [email protected] (Warning: I barely check my email)
- Discord: zcraftelite
Thanks for checking out my Game Session Manager! I hope you find it interesting. Happy gaming!