Skip to content

Let Reddit decide your wallpaper's fate πŸ’€

License

Notifications You must be signed in to change notification settings

kavyachouhan/suppap

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Suppap (Surprise Wallpaper)

GitHub stars GitHub forks GitHub issues GitHub license

Typing SVG

πŸŽ‰ 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:

git clone https://github.com/iamDyeus/suppap.git
cd suppap

2.) Install the required dependencies:

pip install -r requirements.txt
cd src

3.) Run the application:

python main.py

4.) To restore the default wallpaper and stop the application:

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! πŸŽŠπŸ–ΌοΈ

About

Let Reddit decide your wallpaper's fate πŸ’€

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%