/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.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

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.

MaTools Screenshot

🌟 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.13 -y
conda activate whisperx
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia
pip install git+https://github.com/m-bain/whisperx.git
    conda create --name ocrmypdf python=3.10.13 -y
conda activate ocrmypdf
conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia
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

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.