Idiotbox: Youtube interface

Last modification on

Idiotbox is a less resource-heavy Youtube interface. For viewing videos it is recommended to use it with mpv or mplayer with youtube-dl or yt-dlp.

For more (up-to-date) information see the README file.


In my opinion the standard Youtube web interface is:

  • Non-intuitive, too much visual crap.
  • Too resource-hungry, both in CPU and bandwidth.
  • Doesn't work well on simpler (text-based) browsers such as netsurf and links.


  • Doesn't use JavaScript.
  • Doesn't use (tracking) cookies.
  • CSS is optional.
  • Multiple interfaces available: HTTP CGI, command-line, Gopher CGI (gph), this is a work-in-progress.
  • Doesn't use or require the Google API.
  • CGI interface works nice in most browsers, including text-based ones.
  • On OpenBSD it runs "sandboxed" and it can be compiled as a static-linked binary with pledge(2), unveil(2) in a chroot.


  • Order by upload date is incorrect (same as on Youtube).
  • Some Youtube features are not supported.
  • Uses scraping so might break at any point.


git clone git://


You can browse the source-code at:

Download releases

Releases are available at:


You can view it here:

For example you can search using the query string parameter "q":

The gopher version is here: gopher://