Python VHDL C Shell Makefile Verilog
Switch branches/tags
Clone or download
mithro Merge pull request #443 from Nancy-Chauhan/master
Change in
Latest commit 202fd35 Jun 19, 2018
Failed to load latest commit information.
.github github: Adding autolabelling for the new boards. May 19, 2018
.travis travis: Fixing generate-prebuilt-list Mar 18, 2018
doc Add XILINX_DIR notes Apr 17, 2018
firmware firmware: stub-out framebuffer/pattern if no main ram May 18, 2018
gateware Replace litex.gen with migen imports in main tree. Mar 18, 2018
platforms platforms/basys3: fix platform name to basys3 May 18, 2018
scripts scripts: Restore the nullglob setting. Mar 19, 2018
software/pcie pcie/kernel/main: remove soft reset Jan 30, 2017
targets Merge pull request #438 from mithro/basys-fix May 19, 2018
test tests: Fixing the common bits. Dec 29, 2017
third_party Updating submodules. Mar 18, 2018
.gitignore linux: Get litex-devicetree. Dec 31, 2017
.gitmodules Add migen submodule and corresponding script support. Mar 18, 2018
.travis.yml travis: Adding update as travis suggested. May 20, 2018
AUTHORS Fixing up README(s) and LICENSE file. Mar 4, 2017 Adding Code of Conduct Oct 30, 2017 targets: rename HDMI2Ethernet to HDMI2ETH Oct 13, 2015
LICENSE Fixing up README(s) and LICENSE file. Mar 4, 2017
Makefile Add migen submodule and corresponding script support. Mar 18, 2018 Link to current Opsis supplier page Apr 25, 2018 flash: Fixing other mode. Apr 8, 2018 Update May 31, 2018 Making work. Mar 16, 2017 make: fix ident string Jan 19, 2018 Merge remote-tracking branch 'upstream/master' into merge-arty-soc Oct 14, 2017

HDMI2USB LiteX Firmware

Quick Links

Table of contents

  • Overview
  • HDMI2USB LiteX Firmware
    • Supported Boards
    • In Progress Boards
    • Other Boards
  • Getting started
  • Documentation
  • License
  • Contact


The HDMI2USB project develops affordable hardware options to record and stream HD videos (from HDMI & DisplayPort sources) for conferences, meetings and user groups.

We are currently developing our own hardware (the Numato Opsis, and also provide firmware for various prototyping boards.

HDMI2USB started in 2013, and is an active ongoing project in its third iteration of hardware prototyping. Today you can download early working firmware and have real capture happen, but we actively wish to improve and are seeking assistance:

  • For video recording individuals+teams: Be an early adopter; get a board, start using it, report back to us with feedback

  • For software/FPGA developers: Get involved in contributing code both to the capture software + FPGA stack

Our aim is this becomes the defacto, incredibly affordable and easy to use video recording hardware for conferences, meetings and user groups worldwide.

Find out more about HDMI2USB and why we're doing this in ABOUT + FAQ

HDMI2USB Diagram

HDMI2USB LiteX Firmware

Supported Boards

This firmware is supported on the following to boards for capturing conferences;

For a comparison between the supported boards, see the HDMI2USB Hardware page.

In Progress Boards

The following boards are under development for conference capture;

  • Digilent Nexys Video
  • Alphamax NeTV2

Other Boards

The following boards are useful for development but not conference capture;

  • Saanlima Pipistrello -


    A small FPGA board with only one HDMI output port. Due to the lack of video inputs, this board is only useful for developers.

  • ScarabHardware miniSpartan6+ -


    A small FPGA board with HDMI input and HDMI output. Due to the low speed ram and USB interface, this board is only useful for developers who want to work on the HDMI subsystem and need a small board that fits in their pocket.

  • Numato MimasV2 -


    A small, cheap FPGA board with a Spartan 6 and DDR RAM. Due to the lack of video input and high speed data interfaces this board can't be used for capture. It can however be used for development of non-capture related firmware features and experimenting with FPGA development.

Getting started

For using a HDMI2USB board, prebuilt versions of the firmware are available in the HDMI2USB-firmware-prebuilt repository.

For helping with the development, instructions for setting up the build environment are found in the file.


User documentation is found on the HDMI2USB website.

High level developer documentation for the firmware can be found in the doc directory. More documentation is found in the source code.

System Diagram


This code was developed by the people found in the AUTHORS file (including major contributions from EnjoyDigital) and released under a BSD/MIT license.

Code under the third_party directory comes from external sources and is available in their own licenses.