{"id":26281138,"url":"https://github.com/udaysinh-git/dither-girl","last_synced_at":"2025-08-13T23:07:45.538Z","repository":{"id":281168947,"uuid":"936367307","full_name":"udaysinh-git/Dither-Girl","owner":"udaysinh-git","description":"A modern image editor with artistic effects and a minimalist dark interface","archived":false,"fork":false,"pushed_at":"2025-03-07T12:37:28.000Z","size":64,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-10T02:03:39.565Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/udaysinh-git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-21T00:50:23.000Z","updated_at":"2025-03-08T07:14:04.000Z","dependencies_parsed_at":"2025-06-10T02:03:43.069Z","dependency_job_id":"9869aac6-7f69-405e-badf-26781189a1ba","html_url":"https://github.com/udaysinh-git/Dither-Girl","commit_stats":null,"previous_names":["udaysinh-git/dither-girl"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/udaysinh-git/Dither-Girl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/udaysinh-git%2FDither-Girl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/udaysinh-git%2FDither-Girl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/udaysinh-git%2FDither-Girl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/udaysinh-git%2FDither-Girl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/udaysinh-git","download_url":"https://codeload.github.com/udaysinh-git/Dither-Girl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/udaysinh-git%2FDither-Girl/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270330595,"owners_count":24565816,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-14T15:19:36.109Z","updated_at":"2025-08-13T23:07:45.518Z","avatar_url":"https://github.com/udaysinh-git.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dither Girl\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg)\n![Python](https://img.shields.io/badge/python-3.12-brightgreen.svg)\n![PyQt6](https://img.shields.io/badge/PyQt-6.4+-orange.svg)\n\nA modern image editor with artistic effects and a minimalist dark interface, built with PyQt6 and OpenCV.\n\n![Dither Girl Screenshot](docs/images/screenshot.png)\n\n## ✨ Features\n\n### 🎛️ Image Adjustments\n- **Basic Controls**: Brightness, contrast, saturation, sharpness, and blur\n- **Non-destructive Editing**: All adjustments preserve original image quality\n- **Real-time Preview**: See changes as you adjust parameters\n\n### 🎨 Special Effects\n- **Filters**: Grayscale, negative, sepia, vignette, warm/cool tones\n- **Artistic Effects**: Cartoon, watercolor, oil painting, emboss, edge detection\n- **Creative Styles**: Posterize, pixelate, glitch, HDR enhancement\n- **Color Manipulation**: Advanced color grading with intensity controls\n\n### 💻 Interface\n- **Modern Design**: Dark minimal aesthetic with monospace fonts\n- **Image Navigation**: Zoom in/out, fit to view, and actual size options\n- **Hand Tool**: Pan easily around large images\n- **History**: Full undo/redo functionality for all operations\n- **File Management**: Open and save in common image formats\n\n## 🚀 Installation\n\n1. Clone the repository:\n   ```sh\n   git clone https://github.com/udaysinh-git/dither-girl.git\n   cd dither-girl\n   ```\n\n2. Install the required dependencies:\n   ```sh\n   pip install -r requirements.txt\n   ```\n\n## 🎮 Usage\n\n1. Run the application:\n   ```sh\n   python main.py\n   ```\n\n2. Using the editor:\n   - **Open an image**: Use File \u003e Open or the Open button\n   - **Apply adjustments**: Use sliders in the sidebar to modify image properties\n   - **Apply effects**: Select an effect from the dropdown and set parameters\n   - **Navigate**: Use zoom controls and the hand tool for large images\n   - **History**: Use undo/redo buttons or Ctrl+Z/Ctrl+Y shortcuts\n   - **Save**: Use File \u003e Save or the Save button\n\n## 🧩 Project Structure\n\n```\ndither-girl/\n├── algorithms/           # Dithering and other core algorithms\n├── edit/                 # Basic image editing filters\n│   ├── image_filters.py  # Core image processing algorithms\n├── effects/              # Special effect implementations\n│   ├── base.py           # Base effect class\n│   ├── cartoon.py        # Cartoon effect implementation\n│   ├── ...               # Other effect implementations\n├── ui/                   # User interface components\n│   ├── components/       # Reusable UI components\n│   ├── main_window.py    # Main application window\n│   ├── styles.py         # UI styling\n├── utils/                # Utility functions\n│   ├── image_loader.py   # Image loading/saving utilities\n├── main.py               # Application entry point\n```\n\n## 🛣️ Roadmap\n\n- [ ] Layer system for non-destructive editing\n- [ ] Custom brushes and drawing tools\n- [ ] Selection tools and masks\n- [ ] Export to additional file formats\n- [ ] Performance optimizations for large images\n- [ ] Additional dithering algorithms\n\n## 🤝 Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Make your changes and commit: `git commit -m 'Add some feature'`\n4. Push to your branch: `git push origin feature-name`\n5. Open a pull request\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and pull request process.\n\n## 💬 Community\n\nJoin our vibrant Discord community to connect with other Dither Girl users and developers!\n\n[![Discord](https://img.shields.io/discord/1347545773176258612?color=7289DA\u0026label=Discord\u0026logo=discord\u0026logoColor=white)](https://discord.gg/ZujvWEYedQ) \n\n### Why Join?\n- **Get Early Access** to beta features and experimental effects\n- **Share Your Creations** and get feedback from fellow artists\n- **Influence Development** by directly engaging with the core team\n- **Troubleshoot Issues** with help from the community and developers\n- **Learn Advanced Techniques** through community tutorials and tips\n\nWe host regular community events including image editing challenges, effect design workshops, and Q\u0026A sessions with the development team!\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgements\n\n- [PyQt6](https://www.riverbankcomputing.com/software/pyqt/intro) for the GUI framework\n- [OpenCV](https://opencv.org/) for image processing capabilities\n- [NumPy](https://numpy.org/) for array operations\n- All contributors who have helped improve this project\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fudaysinh-git%2Fdither-girl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fudaysinh-git%2Fdither-girl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fudaysinh-git%2Fdither-girl/lists"}