https://github.com/mr-mrf-dev/py-screen-saver
🖥️ A simple Screen Saver App Made with Python.
https://github.com/mr-mrf-dev/py-screen-saver
py python python3 tkinter tkinter-python
Last synced: 5 months ago
JSON representation
🖥️ A simple Screen Saver App Made with Python.
- Host: GitHub
- URL: https://github.com/mr-mrf-dev/py-screen-saver
- Owner: Mr-MRF-Dev
- License: mit
- Created: 2023-08-05T10:21:05.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-02-27T21:15:31.000Z (10 months ago)
- Last Synced: 2025-04-21T19:44:43.857Z (8 months ago)
- Topics: py, python, python3, tkinter, tkinter-python
- Language: Python
- Homepage:
- Size: 47.9 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🖥️ Py Screen Saver
[](https://github.com/Mr-MRF-Dev/Py-Screen-Saver/releases)
[](https://github.com/Mr-MRF-Dev/Py-Screen-Saver/actions/workflows/build.yml)
[](/LICENSE)
[](https://github.com/psf/black)
Simple screen saver application using Python's Tkinter library. This app displays a clock at the center of the screen when activated.
## 📥 Installation
you can download the latest version of the app from the [Releases](https://github.com/Mr-MRF-Dev/Py-Screen-Saver/releases) page.
## 🛠 Getting Started
follow the instruction to install Screen Saver App on Windows OS:
1. Clone Code
use [Git](https://git-scm.com/) on your system
```bash
git clone https://github.com/Mr-MRF-Dev/Py-Screen-Saver.git
```
or use [GitHub CLI](https://cli.github.com/)
```bash
gh repo clone Mr-MRF-Dev/Py-Screen-Saver
```
2. Change your directory.
```bash
cd Py-Screen-Saver
```
3. Install [tkinter](https://docs.python.org/3/library/tkinter.html) and [Nuitka](https://pypi.org/project/Nuitka/) ( by using [requirements.txt](https://pip.pypa.io/en/stable/reference/requirements-file-format/) )
```bash
pip install -r requirements.txt
```
4. Create `exe` File with Nuitka
```bash
nuitka --mode=app --assume-yes-for-downloads --enable-plugin=tk-inter --windows-console-mode=disable src/main.py
```
5. Change File Format to `scr`
```bash
ren main.exe Py-Screen-Saver-win.scr
```
6. Move the file to `C:/windows/system32` **(Administrator access is required)**
```bash
mv Py-Screen-Saver-win.scr C:/windows/system32
```
7. Install the new screen saver (with registry):
```bash
reg add "HKEY_CURRENT_USER\Control Panel\Desktop" /v SCRNSAVE.EXE /t REG_SZ /d C:\Windows\system32\Py-Screen-Saver-win.scr /f
```
> reg add flags: `/v` \, `/t` \, `/d` \, `/f` Adds the registry entry without prompting for confirmation.
> [More about reg command](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/reg)
You can also right-click on the `.scr` file and select the "Install" option.
Done :)
## 💡 Tips
- To see all screen savers:
```bash
dir c:\windows\system32\*scr
```
- You can adjust the duration of the screen timeout (600 sec):
```bash
reg add "HKEY_CURRENT_USER\Control Panel\Desktop" /v ScreenSaveTimeOut /t REG_SZ /d 600 /f
```
- Also, you don't need to rename the file to 'scr' extension. Instead, you can directly install the file with the 'exe' extension.
```bash
reg add "HKEY_CURRENT_USER\Control Panel\Desktop" /v SCRNSAVE.EXE /t REG_SZ /d C:\Windows\system32\main.exe /f
```
## 🤝 Contributing
we welcome any contributions you may have. If you're interested in helping out, fork the repository and create an [Issue](https://github.com/Mr-MRF-Dev/Py-Screen-Saver/issues) and [PR](https://github.com/Mr-MRF-Dev/Py-Screen-Saver/pulls).
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](/LICENSE) file for details.