Batch Conversion Tool for TinyTV® 2

A tool for mass converting video files for the highly recommended TinyTV® 2 device by Tiny Circuits!

Index

• Intro
  • Official Tool
  • Batch Conversion Tool
  • Preview
• User Guide
  • Running (Windows)
• Development / Code Contribution
  • Prerequisites
  • Workspace Setup
  • Build / Run
• License(s)
• Wrapping Up

Intro

The Batch Conversion Tool is designed to simplify the process of preparing video files for the TinyTV® 2 device. It offers a user-friendly interface and powerful features to help you convert and manage your video files with ease.

[ Index ]

Official Tool

Before we begin, you should know there's an official TinyTV® 2 Converter app available for use if you wish to use that one instead.

[ Index ]

Batch Conversion Tool

Batch Conversion Tool is an open-source application built with the same purpose as the TinyTV® 2 Converter app but allows you to batch convert many video files at once. It also includes extra features to make preparing your videos easier, such as:

• Converting an entire list of files in sequence.
• Drastically reduce the file size, and display limits for the FAT32 file system.
• Choose from different video quality output settings.
• Automatically prepend filenames with channel numbers for easy sorting.
• Merge multiple videos into a single output file.

Preview(s)

"Convert" Tab Preview:

"Combine" Tab Preview:

[ Index ]

User Guide

Running (Windows)

Go to the releases page and download the latest TinyTV2.Batch.Conversion.Tool.exe file. Once downloaded, run the executable to start the application.

[ Index ]

Development / Code Contribution

You can contribute to the development of TinyTV® 2 Batch Conversion Tool by following these steps:

Prerequisites

1. Make sure you have Python installed and accessible in your PATH:

   python.org/downloads

   Test with:

   python --version
   # or
   py --version

2. Make sure you have ffmpeg installed one of two ways:

   • Install locally and accessible in your PATH: ffmpeg.org/download and/or

   • Binaries (optional): gyan.dev/ffmpeg/builds (placed in bin/)

[ Index ]

Workspace Setup

1. Bootstrap pip:

   py -m ensurepip --upgrade
   py -m pip install --upgrade pip setuptools wheel

2. Install third party dependencies:

   py -m pip install -r requirements.txt
   

3. If you don't want to install ffmpeg locally, place the ffmpeg.exe binary in the bin/ folder. Test:

   cd bin
   ffmpeg -version

[ Index ]

Build / Run

To run the application directly from root for development (requires local ffmpeg or from bin):

py main.py

To build dist/main.exe for production (requires ffmpeg in bin):

py -m PyInstaller --onefile ^
   --windowed ^
   --noconfirm ^
   --name TinyTV2BatchConversionTool ^
   --icon=icon.ico ^
   --add-data "bin;bin" ^
   main.py

[ Index ]

Linting and Formatting

To ensure code quality and consistency, this project uses the following tools:

• Black: An opinionated code formatter for Python.
• Flake8: A linting tool for Python that checks for style guide enforcement.

Run the following command to format your code with Black:

py -m black .

Run the following command to check your code with Flake8:

py -m flake8

License(s)

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. See the license file for more information.

This software uses FFmpeg licensed under the LGPLv2.1 license. Source code for FFmpeg is available at https://ffmpeg.org.

SPDX-License-Identifiers: CC-BY-NC-4.0, LGPLv2.1

The application code is licensed under CC-BY-NC-4.0. FFmpeg is licensed separately under LGPLv2.1. These licenses apply independently.

[ Index ]

Wrapping Up

Thank you to Tiny Circuits for the TinyTV® 2, it's a fun device! If you have any questions, please let me know by opening an issue here.

Type	Info
	webmaster@codytolene.com
	https://github.com/sponsors/CodyTolene
	https://www.buymeacoffee.com/codytolene
	bc1qfx3lvspkj0q077u3gnrnxqkqwyvcku2nml86wmudy7yf2u8edmqq0a5vnt

Fin. Happy programming friend!

Cody Tolene

[ Index ]