PicSort

PicSort is an iOS application designed to help you manage and sort your photos efficiently. The app allows you to swipe through your photo library, keeping or deleting photos with ease. It supports multiple filtering categories and provides a smooth, animated swipe experience similar to Tinder.

Features

• Swipe-to-Sort: Swipe right to keep a photo and left to delete it.
• Category Filtering: Filter photos by Today, Yesterday, Last Week, All, Screenshots, or Videos.
• Video Playback: View videos in full-screen mode with integrated AVPlayer support.
• Animated Swipe Actions: Enjoy an interactive and engaging swipe experience.
• Rounded Image View: Photos are displayed with rounded corners for a modern look.

Installation

Prerequisites

• Xcode 15 or later
• iOS 16.0 or later

Clone the Repository

To get started, clone this repository using Git:

git clone https://github.com/your-username/sort-pic.git
cd sort-pic

Build and Run

1. Open Xcode: Launch Xcode and open the SortPic.xcodeproj file.
2. Select Target Device: Choose a target device or simulator from the Xcode toolbar.
3. Build the Project: Press Cmd + B to build the project and resolve any potential issues.
4. Run the App: Press Cmd + R to run the app on the selected device or simulator.

Usage

1. Launch the App: Open the PicSort app on your device or simulator.
2. Select a Category: Use the segmented control at the bottom of the screen to filter photos. Available categories include:
   • Today: Photos taken today.
   • Yesterday: Photos taken yesterday.
   • Last Week: Photos taken within the last week.
   • All: All photos in the library.
   • Screenshots: Filtered to show screenshots only.
   • Videos: Videos from the library.
3. Swipe Photos: Swipe right to keep a photo or left to delete it. Animated swipe actions provide visual feedback.
4. View Videos: Tap on video thumbnails to play them in full-screen mode using AVPlayer.

Features in Development

• Image and Video Filtering: Enhancements to filtering capabilities based on additional metadata.
• Enhanced User Interface: Further improvements to the app’s design and user interactions.
• Cloud Backup: Integration with cloud services for photo backup and synchronization.

Contributing

We welcome contributions to enhance PicSort. To contribute:

1. Fork the Repository: Click the "Fork" button on GitHub to create your own copy of the repository.
2. Create a Branch: Switch to a new branch for your changes (git checkout -b feature-branch).
3. Make Changes: Implement your changes or new features.
4. Commit Changes: Commit your changes with a descriptive message (git commit -am 'Add new feature').
5. Push Changes: Push your changes to your forked repository (git push origin feature-branch).
6. Create a Pull Request: Open a pull request to merge your changes into the main repository.

License

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

Contact

For any questions, suggestions, or issues, please contact Suraj Van Verma or open an issue on the GitHub repository.

Acknowledgments

• Apple Developer Documentation: For comprehensive resources on iOS development.
• Open Source Libraries: Credits to any third-party libraries or tools used in this project.

---

Developed by Suraj Van Verma. September 15, 2024, Montreal, QC.

### Key Points:
- **Screenshots**: Replace placeholders with actual screenshots.
- **Installation Instructions**: Clearly outline steps to build and run the app.
- **Usage**: Detail how users should interact with the app.
- **Features in Development**: Mention any future enhancements.
- **Contributing Guidelines**: Provide clear instructions for potential contributors.
- **License**: Ensure you have a LICENSE file if you reference it.
- **Contact and Acknowledgments**: Provide ways to contact you and acknowledge any external resources or libraries used.