FrameChanger changes your desktop wallpaper to images from your favorite movies and TV shows using The Movie Database (TMDB) API.

• Add favorite movies and TV shows
• Change wallpaper randomly or to a specific favorite
• Automatic wallpaper changer
• Customizable themes
• Search and filter favorites
• Edit and delete favorites
• System tray integration
• Notifications

Install with pip:

pip install framechanger

1. Clone the repository: git clone https://github.com/SkyCreates/FrameChanger.git cd FrameChanger

2. Install dependencies: pip install -r requirements.txt

3. Run the app: python app.py

Get the latest release from the Releases page on GitHub.

FrameChanger supports Windows, macOS and most Linux desktops. Wallpaper changes rely on system tools such as gsettings or feh on Linux.

• Enter a movie or TV show name and click "Add to Favorites" or press Enter.
• Select "Movie" or "TV Show" using the radio buttons.

• Click "Change Wallpaper" to set a random wallpaper from your favorites.
• Use "Preview Wallpaper" to see a random wallpaper before applying it.
• "Set Local Image" lets you choose any image on your computer.
• Double-click a title in the favorites list to set a specific wallpaper.

• Enable automatic wallpaper changes by clicking "Auto Wallpaper".
• Set the interval for automatic changes.

• Choose a theme from the dropdown menu.
• Themes: Default, Dark, IMDB, TMDB, GreyRed, HighContrast.

• Use the search input to find movies or TV shows.
• Filter by all, movies only, or TV shows only.

• Select a title and click "Edit" to modify it.
• Select a title and click "Delete" to remove it.
• To delete all titles, press and hold "Delete".

• Minimize to the system tray by clicking close.
• Access features from the system tray icon:
• Randomize: Change wallpaper randomly.
• AutoWallpaper Changer Settings: Open auto changer settings.
• Show App: Restore the main window.
• Exit: Quit the app.

• Get notifications for wallpaper changes and other events.

• Database: Uses SQLite to store favorites.
• Settings: Configuration stored in settings.json. Set your TMDB API key with the TMDB_API_KEY environment variable or enter it on first run.

• Developer: Akash Seam
• API: The Movie Database (TMDB)

MIT License. See the LICENSE file for details.

Install dependencies with pip install -r requirements.txt and run tests with pytest.

For questions or feedback, email me at akash.seam@gmail.com.