Arduboy Video Player (1.1) & Arduboy Video Converter (1.0)
Created by Jonathan Holmes (crait)

Website: http://www.crait.net/
Twitter: @crait (http://www.twitter.com/crait)
Bluesky: @crait.bsky.social (http://crait.bsky.social)

The Arduboy Video Player is a video player program that can be put onto your Arduboy FX in order to play videos! I’ve also created the Arduboy Video Converter to convert any video file you want into the correct format for the Arduboy FX to play!

Features:
	- Supports different video sizes and FPS
	- Play/pause
	- Skip to beginning/end
	- Next/previous frame
	- Fast-forward/rewind and backwards play
	- Looping
	- Flip video playback
	- Invert video colors
	- Display metadata (Title, duration, FPS, dimensions)

The Arduboy Video Converter will create the a `.bin` file that contains the video data and metadata, as well as a `video.h` file that must be added to the `Player/` directory in order to compile the Arduino sketch file (`.ino`).

Installation:
	1. Unzip everything somewhere onto your computer
	2. Download and install the Arduino IDE and required Arduboy libraries. For a guide on this, check out my tutorial: https://community.arduboy.com/t/make-your-own-arduboy-game-part-1-setting-up-your-computer/7924/1 . You must also install the Arduboy FX library, too! https://github.com/MrBlinky/ArduboyFX
	3. Download and install FFmpeg onto your computer (https://ffmpeg.org/download.html)
	4. Download and install Node.js (https://nodejs.org/en/download)
	5. Using Command Prompt (or Terminal), navigate to the `Converter/` directory
	6. Use npm to install the Arduboy Video Converter dependencies with `npm install`

Converting Your Video:
	1. Place your video file in the `Converter/` directory
	2. Using Command Prompt (or Terminal), navigate to the `Converter/` directory
	3. Run the Arduboy Video Converter by using `npm start`
	4. You must provide several pieces of information for the video to be converted, such as the video filename, the height, width, FPS, etc. To skip these questions, you can use `npm start [file] [title] [fps] [width] [height] [additional filters]`.
	5. This process will create a `.bin` and `video.h` file in the `Converter/` directory
	6. Move the `video.h` file to the `Player/` directory
	7. Open the `Player.ino` sketch with the Arduino IDE
	8. Connect your Arduboy FX to your computer and compile/upload your sketch to your device
	9. You must also upload the `.bin` that you generated in the `Converter/` directory. To do this, I use Mr.Blinky's tools, but there are alernatives that you could try. (https://github.com/MrBlinky/Arduboy-Python-Utilities)

License:
Code is supplied for 2 purposes: 1) Ease of loading onto an Arduboy device for personal play, and 2) Educational value in the case of studying the code and modifying for personal, educational use. Even though the source code is available to the public, this software is not 'open-source'. Re-releasing my code/game, re-distributing my code/game, or publicly sharing a modified variation or derivative of my code/game is not allowed. The code has no guarantee of support in the future. The code is also free of charge. This code must never be sold. This game must never be sold. Distribution of my game/code for commercial or financial gain is explicitly NOT allowed. Finally, someone creating any derivative of this software for a different platform must have explicit permission from me if it is intended to be released or distributed to others. Please don't steal my code!
