Programming the TinyTV or Tiny Video Player

Get ready to learn how to upload your favorite movies and videos into a screen you can comfortably fit in the palm of your hand. You can take this project on the road with some movies loaded on it, or use it in your next project that needs some tiny video.
TinyTV and Tiny Video Player kits are shipped with the TV and Video Player programs pre-uploaded, respectively. This tutorial is for those that wish to get more involved in the programming aspect. If you are interested in looping or auto playing videos, or want to turn off the TV mode that starts playing all videos once the unit is turned on - please refer to the Settings Menu Tutorial. The settings menu has some commonly-asked-for functionality options that can be toggled without doing any programming!
If this is your first time programming with the TinyScreen+, please go through the TinyScreen+ Setup Tutorial so that you have the TinyScreen library downloaded before proceeding.
Materials
Hardware:
- Micro USB Cable
- DIY TinyTV Kit or Tiny Video Player Kit or Individual Components:
- TinyScreen+ Processor Board] - Runs the program, has a SAMD 32-bit processor, OLED screen, USB and power circuitry.
- Micro SD / Audio TinyShield - Designed specifically for use with the TinyScreen+, this TinyShield has the micro SD card adapter, audio driver and IR receiver (which can receive TV remote control signals).
- 290 mAh Rechargeable Lithium Polymer Battery - Used to power your video player, and is recharged when the USB is plugged into the TinyScreen+ board.
- 16x9 Speaker - for audio playback on videos
- 8GB Micro SD card and Adapter - preloaded with sample videos.
Software:
- Arduino IDE - used to program the processor on the TinyScreen+
- Arduino Program zip file Tiny Video Player / TinyTV - this will need uploaded using the Arduino IDE. This program can display both the Tiny Video Player, or the TinyTV program by toggling options on the Settings Menu. The default setting is for the TinyTV.
- TSV Converter Tutorial - Use this App for MacOS or Windows to convert .mp4 files into a format that will work on the TinyScreen+
Software
If you have not already, download the Arduino IDE. This is the platform, or application we will use to upload a program to the TinyScreen+ so that it will work as a Tiny Video Player.
Download the following zipped folder of the TinyTV / Video Player program, unzip the folder, and double-click the 'TinyTV.ino' file to open the program in the Arduino IDE:
Once downloaded, extract the files to a destination of your choice. Navigate to the unzipped folder and open TinyTV.ino. Turn the switch on the TinyScreen+ to ON, and plug it into your computer using a Micro USB cable.
To program the TinyScreen+, you need to make these selections under the Tools tab:
- Tools -> Board -> "TinyScreen+"
- Tools -> Port -> "COM##(TinyScreen+)"
- Programmer -> "Arduino as ISP"

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 micro SD card in the order you added them.
If you have any issues finding the correct port, you can unplug the microUSB cable and plug it back in while noting which COM## disappears and reappears during this process.
How it works
After the program is uploaded, the TinyTV will begin playing the first video listed on the SD Card with a .tsv extension. Each video on the SD Card will show up as a "channel" that you can scroll through with the channel buttons on the remote. The videos all begin playing as soon as the TinyTV is turned on to mimic a real TV. When left on a channel, the video on that "channel" will repeat. Use the Tiny Remote to control your TinyTV from a distance (the remote works best about 12-18in. away from an IR Receiver. Works best with the TinyTV when pointed toward the top - where the receiver is), or use the following diagram of button functions right on the TinyTV enclosure:

To customize your viewing experience, you can use the Settings Menu Tutorial to turn off the TinyTV program for the Tiny Video Player program. Additionally you can toggle Auto Play, and Looping settings to customize your palm-sized video display.
The Tiny Video Player program will display a side-scrolling menu of all the files on the SD Card that have the .tsv extension in order. The Tiny Video Player program has the following functionality programmed for the TinyScreen+ buttons:

If you want to add some new videos or movies to your SD Card, you can move on to the TSV Converter tutorial that shows you exactly how to do that using the TSV (TinyScreen Video) Converter. To sum up using the TSV Converter, you simply need to download either the MacOS or Windows app, open it and then upload the files you want to convert to the .tsv format. The converted videos will automatically save to the same file location as the original video. The videos you would like to play on the Tiny Video Player then just need moved onto the SD card being used in the project.
Contact Us
If you have any questions or feedback, feel free to email us or make a post on our forum. Show us what you make by tagging @TinyCircuits on Instagram, Twitter, or Facebook so we can feature it.
Thanks for making with us!