Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/inc44/matools
An all-in-one GUI management toolkit built with PyQt6, offering a suite of tools for file synchronization, media organization, PDF merging, code formatting, and more.
https://github.com/inc44/matools
application audio-processing code-formatting file-management gui image-processing ocr pdf-processing productivity python qt rust speech-recognition video-processing youtube-downloader
Last synced: 5 days ago
JSON representation
An all-in-one GUI management toolkit built with PyQt6, offering a suite of tools for file synchronization, media organization, PDF merging, code formatting, and more.
- Host: GitHub
- URL: https://github.com/inc44/matools
- Owner: Inc44
- License: gpl-3.0
- Created: 2023-09-05T19:37:54.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-13T22:46:15.000Z (10 months ago)
- Last Synced: 2024-04-14T12:19:19.393Z (10 months ago)
- Topics: application, audio-processing, code-formatting, file-management, gui, image-processing, ocr, pdf-processing, productivity, python, qt, rust, speech-recognition, video-processing, youtube-downloader
- Language: Python
- Homepage:
- Size: 6.24 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MaTools: A Comprehensive Management Toolkit
MaTools is an all-in-one GUI application, created using PyQt6, that offers a suite of tools for various tasks, all within an efficient, user-friendly interface.
## 🌟 Features
- 🎵 Audio Speech Recognition*
- 📖 Optical Character Recognition
- 🎧 YouTube Audio Downloader
- 📝 PDF Merger
- 🎨 SVG to PNG Converter
- 🎬 FFmpeg Video Trim
- 🐍 Python Code Formatter
- 📂 File Sync
- 📅 Media Date Organizer
- 🔇 Silence Remover
- 🖼️ Image Trimmer
- 🛠️ And much more!
\* I would advise to pre-process the audio using [Ultimate Vocal Remover](https://github.com/Anjok07/ultimatevocalremovergui)
## 🚀 Getting Started
### Installation Steps
1. Set up a Conda environment:
```bash
conda create --name MaTools python=3.10.13
conda activate MaTools
```
1. **Clone the Repository**:
```bash
git clone https://github.com/Inc44/MaTools.git
```
2. **Navigate into Project Directory**:
```bash
cd MaTools
```
3. **Install Dependencies**:
```bash
pip install -r requirements.txt
```
4. **Create Conda Enviroments (Optionally to avoid conflicts)**:
```bash
conda create --name whisperx python=3.10 -y
conda activate whisperx
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia -y
pip install git+https://github.com/m-bain/whisperx.git
pip install numpy==1.26.4
```
```bash
conda create --name ocrmypdf python=3.10 -y
conda activate ocrmypdf
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia -y
pip install ocrmypdf
pip install git+https://github.com/ocrmypdf/OCRmyPDF-EasyOCR.git
```
5. **Launch the Application**:
Launch from cmd:
```bash
python -OO main_management_tools_app.pyw
```
Linux shortcut:
```bash
~/miniconda3/envs/MaTools/bin/python -OO ~/MaTools/management_tools/main_management_tools_app.pyw
```
Windows shortcut:
```cmd
C:\ProgramData\miniconda3\envs\MaTools\pythonw.exe -OO Y:\pc\github\MaTools\management_tools\main_management_tools_app.pyw
```
### Important Links
- [Anaconda](https://www.anaconda.com/download) - Conda GUI or [Miniconda](https://docs.conda.io/projects/miniconda/en/latest) - Conda CLI
- [Efficient Compression Tool](https://github.com/fhanau/Efficient-Compression-Tool.git) - Photo Compressor
- [ExifTool](https://exiftool.org/) - Metadata
- [FFmpeg](https://www.gyan.dev/ffmpeg/builds/) - Media
- [Tesseract](https://github.com/UB-Mannheim/tesseract/wiki) - OCR processor
- [Unpaper](https://github.com/rodrigost23/unpaper/releases) - OCR preprocessor
- [yt-dlp](https://github.com/yt-dlp/yt-dlp.git) - Media downloader
### System Requirements
Ensure these binaries are in your system's PATH:
- `ect.exe` - Version 0.9.4 tested
- `exiftool.exe` - Version 12.59 tested
- `ffmpeg.exe` - Version 6.0 tested
- `unpaper.exe` (and its dlls) - Version 6.1 tested
- `yt-dlp.exe` - Version 2023.07.06 tested
#### Adding Binaries to System Path
1. Download the necessary binaries.
2. Include them in your system's PATH, e.g., `C:\Windows\`.
Check their presence:
```bash
ect.exe --version
exiftool.exe -ver
ffmpeg.exe -version
yt-dlp.exe --version
unpaper --version
```
## 🛠️ Usage
After launching, the toolbar at the top showcases icons for various tools. Hover over an icon to see its description. Click to activate the respective tool.
## 🎨 Customization
MaTools allows theme tweaks. To modify the theme, adjust the `theme_name` variable in the main script:
```python
theme_name = "white_flat_theme" # Choose your preferred theme
```
## 🤝 Contribution
Contributions are heartily welcomed! If you're considering significant modifications, please initiate an issue for discussions before submitting a pull request.
## 📜 License
This software is under the GNU General Public License v3.0 (GPL-3.0). For comprehensive details, refer to [LICENSE](LICENSE).