https://github.com/iamdyeus/suppap
Let Reddit decide your wallpaper's fate 💀
https://github.com/iamdyeus/suppap
hacktoberfest hacktoberfest-accepted prankware python reddit reddit-bot wallpaper wallpaper-changer
Last synced: 8 months ago
JSON representation
Let Reddit decide your wallpaper's fate 💀
- Host: GitHub
- URL: https://github.com/iamdyeus/suppap
- Owner: iamDyeus
- License: mit
- Created: 2024-10-26T20:02:50.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-28T08:37:26.000Z (over 1 year ago)
- Last Synced: 2024-10-28T10:36:54.329Z (over 1 year ago)
- Topics: hacktoberfest, hacktoberfest-accepted, prankware, python, reddit, reddit-bot, wallpaper, wallpaper-changer
- Language: Python
- Homepage:
- Size: 85.4 MB
- Stars: 1
- Watchers: 2
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Suppap (Surprise Wallpaper)
[](https://github.com/iamDyeus/suppap/stargazers)
[](https://github.com/iamDyeus/suppap/network/members)
[](https://github.com/iamDyeus/suppap/issues)
[](https://github.com/iamDyeus/suppap/blob/main/LICENSE)
### 🎉 Surprise Your Friends with Random Wallpapers!
Suppap (short for Surprise Wallpaper) is a fun, mischievous little application designed to add a dash of excitement to your (or your friends') computer experience. It periodically changes the desktop wallpaper to random images from popular subreddits, keeping things fresh and unpredictable!
### 🚀 Main Features
- Automatically downloads images from selected subreddits
- Changes wallpaper at set intervals
- Works on Windows, macOS, and Linux
- Easy to set up and run in the background
- Perfect for pranking friends or adding variety to your own desktop
### 🛠 Setup and Installation
1.) Clone the repository:
```bash
git clone https://github.com/iamDyeus/suppap.git
cd suppap
```
2.) Install the required dependencies:
```bash
pip install -r requirements.txt
cd src
```
3.) Run the application:
```bash
python main.py
```
4.) To restore the default wallpaper and stop the application:
```bash
python main.py --back-to-normal
```
### ⚙ Configuration
You can customize the application by editing the config.py file:
- Change the wallpaper update interval
- Add or remove subreddits to fetch images from
- Modify the image folder location
### 🎭 Prank Ideas
- Secretly install it on a friend's computer for a harmless prank
- Set it up on public computers in your office or school (with permission, of course!)
- Use it for a fun party game - guess the subreddit!
### 🤝 Contributing
We'd love your help to make Suppap even more awesome! Here are some ideas:
- Implement a better CLI for easier configuration
- Add support for more image sources beyond Reddit
- Create a feature to schedule different wallpaper themes for different times of day
- Improve error handling and logging
- Write unit tests to ensure reliability
- Add a feature to blend or transition between wallpapers
Feel free to fork the repo and submit pull requests with your improvements!
### ⚠️ Disclaimer
Please use Suppap responsibly. Always get permission before installing it on someone else's computer, and be mindful of potentially inappropriate content from Reddit.
### 📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
Remember, with great power comes great responsibility... to prank your friends responsibly! Enjoy Suppap! 🎊🖼️