Skip to content

TSVConverter: What is it and how do I use it?

.TSV (TinyScreen Video) is a file format used to play video on our TinyScreen products, including our TinyScreen+ and the Tiny Arcade. This article will cover how to use the Windows and MacOS program to convert any common video format to a .TSV file. It will also demonstrate how to play .TSV files on your TinyScreen+ with the microSD TinyShield.

For more information on how to load .TSV files to your TinyArcade, please refer to the How to Load TinyArcade Games & Videos onto an SD Card tutorial.


Using the Program

Download the TSV Converter app here:


MacOS Download:

The Mac operating system has some extra security measures, so to open the MacOS TSV Converter, you will likely need to select "Open When Done" to force it to complete the download:

Navigate to where the program has downloaded in your Finder, double click the zip file to unzip it, then right click to Open the file. 

Once the TSV Converter has successfully downloaded, you should be able to open it:

You are now ready to select some video files to convert!


Windows Download:

Open the TSV Converter by double-clicking the file.

Once the program is open, click "File" and select the option that says "Open." This will open your file explorer and allow you to select a video file.

After you've selected a file, open the "File" menu again and select convert. That's it! The .TSV file should appear in the same folder as your selected file. If you want to edit the output of your movie, you can go under "Options" to select your output's aspect ratio, bit quality, and enable or disable audio.


Playing .TSV Files on the TinyScreen+

If this is your first time using the TinyScreen+, please refer to the TinyScreen+ Setup Tutorial. Make sure to add the microSD TinyShield or microSD and Audio TinyShield to the stack.

After converting your .TSV file, you will need to add it to your microSD card. Copy and paste the file into your microSD card directory as shown below.

Once you've added the file(s) you wish to play on your TinyScreen+, you just need to be sure that the Tiny Video Player program is uploaded. If you have not yet uploaded the program, you can go to the Tiny Screen Video Player tutorial for a more in depth tutorial on how to upload the program. Otherwise, the zip file for the program is here: 

Once downloaded, extract the files to a destination of your choice. Navigate to the unzipped folder and open TinyScreenVideoKit.ino. Your Arduino IDE should look like this:

Once you've ensured the Board and Port selections under the Tools tab are correct, upload the sketch. Your TinyScreen+ should begin playing the videos stored on your microSD card in the order you added them.


Questions? Concerns?

If you have any issues converting your video, or you think you found a bug in our program, feel free to email us at info@tinycircuits.com or make a post on the forum.

Show us what you make by tagging @TinyCircuits on Instagram, Twitter, or Facebook so we can feature it!

Thanks for making with us!