ConvertLite

ConvertLite is a versatile file conversion tool built with Python and PyQt5, supporting image, video, and document formats. It offers a simple drag-and-drop interface for easy file conversion. Logo generated using AI (Bing in the 24th Februrary 2024 - 21:16).

Features

• Image Conversion: Supports formats like PNG, JPG, JPEG, GIF, BMP, and SVG.

• Video Conversion: Supports MP4, MOV, MKV formats.

• Document Conversion: Support for PDF format.

• Click or drag a file into the program

• Select which type you want to convert it in or shift+click to also adjust image/video settings

• Get the converted file in the same directory as the old one

• I also want to add batch/bulk conversion later

Installation

Prerequisites

• Python 3.6 or newer.
• ffmpeg for video processing.

Setup

1. Clone the repository:

git clone https://github.com/TRC-Loop/ConvertLite.git
cd ConvertLite

2. Install Python Dependencies:

Without a virtual environment:

pip install -r requirements.txt

Or with a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
pip install -r requirements.txt

3. Install ffmpeg:

• macOS:

  brew install ffmpeg

  You may have to install Homebrew: Homebrew Official Website Then run the installation command.

• Linux:

  sudo apt update
  sudo apt install ffmpeg

• Windows:

  Download and install ffmpeg from ffmpeg.org. Add the path to the ffmpeg binary to your system's PATH variable.

Test FFMPEGinstallation:

Type: ffmpeginto your terminal. You should get something like Copyright or the version. If it is not found see Troubleshooting

Usage

To start ConvertLite, navigate to the project directory and run:

python main.py

if python doesnt work, try python3 (macOS/Linux) or py (Windows).

Troubleshooting

Wrong Python/Not Found

• Make sure you have installed python
• Libraries installed but you still get a ModuleNotFound Error

if python doesnt work, try python3 (macOS/Linux) or py (Windows). if there are problems with packages please try:

python -m pip install ... (Windows)
python3 -m pip install ... (MacOS)
py -m pip install ... (Windows)
pip install ... (Windows)
pip3 install ... (MacOS)

Windows Commands may also work on MacOS and MacOS Commands may also work on Windows.

ffmpeg not found

If you encounter an error stating that ffmpeg could not be found, ensure that ffmpeg is correctly installed and its path is added to your system's PATH environment variable. Alternatively, you can set the IMAGEIO_FFMPEG_EXE environment variable to the path of the ffmpeg executable.

Setting the IMAGEIO_FFMPEG_EXE variable:

• macOS/Linux:

  export IMAGEIO_FFMPEG_EXE=/path/to/ffmpeg

• Windows:

  set IMAGEIO_FFMPEG_EXE=C:\path\to\ffmpeg.exe

Python Package Issues

If you face issues with Python packages, ensure you have the correct version of Python installed and you are using the correct pip version (pip, pip3, or specifying with python -m pip). Reinstall the dependencies ensuring no errors are encountered during the installation.