LandonPerkinsProsser / SimpleImageGalleryFilterer

A multi-image gallery with image filtering.

SIGF is a user-friendly Python application created by Landon Perkins at Prosser that allows you to browse a collection of images, apply various image filters, convert images to PNG format, and save or load images with ease.

NOTE: THIS PROJECT IS COMPLETE AND MAY NO LONGER GET UPDATES!

Table of Contents

• Features
• Requirements
• Getting Started
• Usage
• Contributing
• License

Features

• Browse and navigate through a collection of images.
• Apply various image filters, including blur, sharpen, smooth, detail, contour, and emboss.
• Crop/zoom into the center of the image based on how many pixels you want it to zoom into.
• Save edited images or load your own.
• Easy-to-use graphical user interface.

Requirements

SIGF relies on several Python libraries and modules. Ensure you have the following requirements installed before using the application:

• Python: SIGF is built with Python and should work on any system with Python installed.
• Tkinter: Tkinter is used for the graphical user interface and opening save and open file windows.
• Pillow: Pillow is used for image processing and manipulation.
• Pygame: Pygame is used to play background music.
• WinSound: A standard python module for playing sound effects.
• Random: A Python standard library module used for generating random numbers.
• OS: A Python standard library module used for operating system-related functions.
• WebBrowser: A Python standard library module used for opening web links.

Getting Started

1. Clone the Repository:

   • Clone this repository to your local machine using the following command:

     git clone https://github.com/LandonPerkinsProsser/SimpleImageSlideshow.git

2. Install Dependencies:

   • Ensure you have Python installed on your system.
   • Install the required Python packages using pip:

     pip install pillow pygame

3. Run the Application:

   • Navigate to the cloned repository's directory.
   • Run the main.py file:

     python main.py

Usage

SIGF is designed to be intuitive and user-friendly. Here's how to use the application:

• Navigation:

  • Click the "Next Image" button to go forward a image in the image gallery.
  • Click the "Previous Image" button to go back a image in the image gallery.
  • Use the "File" menu to open, save, or reset images.

• Image Filters:

  • Use the "Edit" menu to apply various image filters such as blur, sharpen, smooth, detail, contour, and emboss.

• Background Music:

  • Control the background music with the "Music" menu by toggling it on/off.

• Help and Info:

  • Access additional information about the application through the "Help" menu, which includes credits and a link to the source code repository.

Contributing

Contributions to SIGF are welcome! If you have any suggestions, bug reports, or feature requests, please feel free to open an issue or submit a pull request on the GitHub repository. Your contributions will help improve and enhance the application for everyone.

Credits

• The images are not created by me, the first image is from the Mexican Government when they unvailed a "Alien" to the public, the second image being of the smurf cat meme by Nate Hallinan, the third image being Spongebob by Nickelodeon, the fourth image being Jonesy from Fortnite by Epic Games, and the last image being of the Python Logo on a global internet background by the Python Foundation.
• The sounds come from Nintendo games and software, the button sound comes from multiple sounds from the DSi Shop just combined together, the edit sound comes from multiple sounds from the Mii Channel also combined together, and the save sound comes straight from Mario Kart Wii.
• The background music is from the DSi Camera app by Nintendo.

License

This project is licensed under the MIT License - see the LICENSE file for details.