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

🚀 Getting Started

Installation Steps

1. Set up a Conda environment:

   conda create --name MaTools python=3.10.13
   conda activate MaTools

2. Clone the Repository:

   git clone https://github.com/Inc44/MaTools.git

3. Navigate into Project Directory:

   cd MaTools

4. Install Dependencies:

   pip install -r requirements.txt

5. Create Conda Enviroments (Optionally to avoid conflicts):

   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

   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

6. Launch the Application:

   Launch from cmd:

   python -OO main_management_tools_app.pyw

   Linux shortcut:

   ~/miniconda3/envs/MaTools/bin/python -OO ~/MaTools/management_tools/main_management_tools_app.pyw

   Windows shortcut:

   C:\ProgramData\miniconda3\envs\MaTools\pythonw.exe -OO Y:\pc\github\MaTools\management_tools\main_management_tools_app.pyw

Important Links

• Anaconda - Conda GUI or Miniconda - Conda CLI
• Efficient Compression Tool - Photo Compressor
• ExifTool - Metadata
• FFmpeg - Media
• Tesseract - OCR processor
• Unpaper - OCR preprocessor
• yt-dlp - 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:

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:

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.