diff --git a/DEVELOPMENT_PLAN.md b/DEVELOPMENT_PLAN.md index 4f6e84e..45bf236 100644 --- a/DEVELOPMENT_PLAN.md +++ b/DEVELOPMENT_PLAN.md @@ -2,7 +2,7 @@ ## Project Overview -**Repository**: [https://github.com/DandelionBold/GIF-Tools.git](https://github.com/DandelionBold/GIF-Tools.git) +**Repository**: [https://github.com/KamalNady/GIF-Tools.git](https://github.com/KamalNady/GIF-Tools.git) **License**: MIT **Architecture**: Modular design with core library, desktop GUI, and future web API **Testing Strategy**: Unit tests, integration tests, and performance benchmarks diff --git a/LICENSE b/LICENSE index e96fe0b..38638fe 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2025 DandelionBold +Copyright (c) 2025 Kamal Nady Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index 9467191..a74fde3 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ A comprehensive library and desktop application for GIF processing and manipulat ## 🚀 Features ### ✅ **IMPLEMENTED TOOLS** (Ready to Use) + - **Video to GIF** - Convert video files to animated GIFs with auto-optimization - **Resize** - Change GIF dimensions with aspect ratio control and quality settings - **Rotate** - Rotate GIFs by 90°, 180°, or 270° degrees with progress tracking @@ -17,11 +18,13 @@ A comprehensive library and desktop application for GIF processing and manipulat - **Rearrange** - Advanced drag-and-drop frame reordering with visual preview ### 🔄 **IN PROGRESS** (Partially Implemented) + - **Split** - Extract individual frames from GIFs - **Merge** - Combine multiple GIFs or images into one - **Add Text** - Overlay text with customizable fonts and colors ### 📋 **PLANNED TOOLS** (Coming Soon) + - **Reverse** - Play GIF animations backwards - **Optimize** - Reduce file size while maintaining quality - **Speed Control** - Adjust playback speed @@ -33,6 +36,7 @@ A comprehensive library and desktop application for GIF processing and manipulat - **Watermark** - Add image or text watermarks ### 🎨 **Desktop Application Features** + - **Modern GUI** - Professional interface built with tkinter - **Visual Crop Tool** - Click-and-drag cropping with 15+ aspect ratio presets - **Auto-Loading** - Tools automatically load selected GIFs from main dashboard @@ -42,6 +46,7 @@ A comprehensive library and desktop application for GIF processing and manipulat - **Aspect Ratio Presets** - Free, Square, Classic, Camera, Widescreen, Portrait, Vertical, and more ### 🌐 **Future Web API** + - RESTful API for web integration - Async processing for large files - Docker containerization ready @@ -49,12 +54,14 @@ A comprehensive library and desktop application for GIF processing and manipulat ## 📊 **Current Development Status** ### **Phase 1: Core Infrastructure** ✅ **COMPLETED** + - Project structure and architecture - Core library with modular design - Desktop GUI framework - Basic tool integration ### **Phase 2: Basic Tools** ✅ **COMPLETED** + - Video to GIF conversion with auto-optimization - Resize tool with aspect ratio control - Rotate tool with progress tracking @@ -62,11 +69,13 @@ A comprehensive library and desktop application for GIF processing and manipulat - Advanced rearrange tool with drag-and-drop ### **Phase 3: Advanced Tools** 🔄 **IN PROGRESS** + - Split tool (frames extraction) - Merge tool (combine GIFs) - Add Text tool (text overlay) ### **Phase 4: Polish & Optimization** 📋 **PLANNED** + - Performance optimization - Additional effects and filters - Batch processing @@ -75,13 +84,15 @@ A comprehensive library and desktop application for GIF processing and manipulat ## 📦 Installation ### Prerequisites + - Python 3.8 or higher - FFmpeg (for video processing) ### Quick Start + ```bash # Clone the repository -git clone https://github.com/DandelionBold/GIF-Tools.git +git clone https://github.com/KamalNady/GIF-Tools.git cd GIF-Tools # Create virtual environment @@ -101,6 +112,7 @@ python -m desktop_app.main ``` ### Development Installation + ```bash # Install development dependencies pip install -r requirements/dev.txt @@ -118,11 +130,13 @@ flake8 gif_tools desktop_app web_api tests ## 🛠️ Usage ### Desktop Application + ```bash python -m desktop_app.main ``` ### Python Library + ```python from gif_tools import video_to_gif, resize, rotate @@ -199,10 +213,10 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file ## 📞 Support -- 🐛 [Report a bug](https://github.com/DandelionBold/GIF-Tools/issues) -- 💡 [Request a feature](https://github.com/DandelionBold/GIF-Tools/issues) -- 📧 [Contact us](mailto:dandelionbold@example.com) +- 🐛 [Report a bug](https://github.com/KamalNady/GIF-Tools/issues) +- 💡 [Request a feature](https://github.com/KamalNady/GIF-Tools/issues) +- 📧 [Contact us](mailto:kamalnady@example.com) --- -**Made with ❤️ by DandelionBold** +**Made with ❤️ by Kamal Nady** diff --git a/desktop_app/main.py b/desktop_app/main.py index f8f1d06..6f7798b 100644 --- a/desktop_app/main.py +++ b/desktop_app/main.py @@ -5,7 +5,7 @@ A comprehensive desktop GUI application for GIF manipulation with 17 powerful tools. Built with Tkinter for cross-platform compatibility. -Author: DandelionBold +Author: Kamal Nady License: MIT """ @@ -761,7 +761,7 @@ def show_about(self): • Extract frames, loop settings, format conversion • Batch processing and watermarking -Author: DandelionBold +Author: Kamal Nady License: MIT """ messagebox.showinfo("About GIF-Tools", about_text) diff --git a/docs/source/conf.py b/docs/source/conf.py index f2a9236..82d76ac 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -7,8 +7,8 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information project = 'GIF-Tools' -copyright = '2025, DandelionBold' -author = 'DandelionBold' +copyright = '2025, Kamal Nady' +author = 'Kamal Nady' release = '0.1.0' # -- General configuration --------------------------------------------------- diff --git a/docs/source/index.rst b/docs/source/index.rst index bd8ca89..8a4d7cb 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -59,7 +59,7 @@ For development installation: .. code-block:: bash - git clone https://github.com/DandelionBold/GIF-Tools.git + git clone https://github.com/KamalNady/GIF-Tools.git cd GIF-Tools pip install -e . diff --git a/docs/source/installation.rst b/docs/source/installation.rst index 53a9ac1..9e37141 100644 --- a/docs/source/installation.rst +++ b/docs/source/installation.rst @@ -37,14 +37,14 @@ Installing GIF-Tools **From source:** .. code-block:: bash - git clone https://github.com/DandelionBold/GIF-Tools.git + git clone https://github.com/KamalNady/GIF-Tools.git cd GIF-Tools pip install -e . **Development installation:** .. code-block:: bash - git clone https://github.com/DandelionBold/GIF-Tools.git + git clone https://github.com/KamalNady/GIF-Tools.git cd GIF-Tools pip install -r requirements/dev.txt pip install -e . diff --git a/gif_tools/__init__.py b/gif_tools/__init__.py index f9ba6cf..3f548b5 100644 --- a/gif_tools/__init__.py +++ b/gif_tools/__init__.py @@ -6,8 +6,8 @@ """ __version__ = "0.1.0" -__author__ = "DandelionBold" -__email__ = "dandelionbold@example.com" +__author__ = "Kamal Nady" +__email__ = "kamalnady@example.com" __license__ = "MIT" # Import core modules diff --git a/pyproject.toml b/pyproject.toml index 6854093..b45a79e 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -9,10 +9,10 @@ description = "A comprehensive library and GUI application for GIF processing an readme = "README.md" license = {text = "MIT"} authors = [ - {name = "DandelionBold", email = "dandelionbold@example.com"} + {name = "Kamal Nady", email = "kamalnady@example.com"} ] maintainers = [ - {name = "DandelionBold", email = "dandelionbold@example.com"} + {name = "Kamal Nady", email = "kamalnady@example.com"} ] keywords = [ "gif", @@ -77,11 +77,11 @@ all = [ ] [project.urls] -Homepage = "https://github.com/DandelionBold/GIF-Tools" +Homepage = "https://github.com/KamalNady/GIF-Tools" Documentation = "https://gif-tools.readthedocs.io" -Repository = "https://github.com/DandelionBold/GIF-Tools.git" -Issues = "https://github.com/DandelionBold/GIF-Tools/issues" -Changelog = "https://github.com/DandelionBold/GIF-Tools/blob/main/CHANGELOG.md" +Repository = "https://github.com/KamalNady/GIF-Tools.git" +Issues = "https://github.com/KamalNady/GIF-Tools/issues" +Changelog = "https://github.com/KamalNady/GIF-Tools/blob/main/CHANGELOG.md" [project.scripts] gif-tools = "desktop_app.main:main"