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!

Note: This tool is a rapid prototype built with assistance from an AI pair-programming tool to speed up development. The goals of this project are primarily:

• To create a useful tool for TinyTV® 2 users.
• To learn how to build quick Windows desktop applications with Python and Tkinter.
• To be able to create more ffmpeg-based wrapper tools in the future for other devices.
• To effectively put together linting and formatting tools for Python projects.
• To learn how to package and build standalone Windows executables with PyInstaller.

If you find this tool useful, please consider supporting my work. Your support helps me continue developing and maintaining this project. If you have any questions, suggestions, or issues, please feel free to reach out or open an issue on the GitHub repository.

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

Fin. Happy programming friend!

Cody Tolene

[ Index ]