Dicaffeine Dicaffeine


Important FAQ

  • Administration is secured by password, default is admin.
  • If you forgot your password, just use command: rm /etc/dicaffeine/dauth.json and reboot to restore the default one.
  • Dicaffeine is now completely for free! No license is required, all features should work.
  • Running stream can be stopped by mouse right-click, keyboard key ESC and q or remotely via web access.
  • On Raspberry only fresh and clean instalations of Raspberry Pi OS (32-bit) with desktop based on Debian Buster Raspian Buster are supported! It's possible that Dicaffeine will not work correctly with other packages.
  • On ADM/Intel only fresh and clean instalations of Xubuntu (64-bit, 20.04) with desktop are supported! It's possible that Dicaffeine will not work correctly with other packages, just sayin.
  • The reason for the past two lines is because the Dicaffeine is using sound card/video grabbers/web interface which can be blocked by other installed applications.
  • Current version is still beta, some functions could be missing and some won't work as expected.
  • Any issues can be reported at GitHub Dicaffeine page.

Another FAQ, not so important

  • I can see screen tearing:
    • On Raspi3/4 use the cmd raspi-config tool and enable GL driver and disable compositor (advaced→GL Driver-G2 GL; advaced→compositor disable). Sometimes it helps. :)
    • On AMD/Intel with NVidia graphic card use the nvidia-settings GUI tool and in Display Configuration→Advanced… enable Force Composition Pipeline.
    • On Intel with integrated graphic card enable the “TearFree” option in the xorg.conf configuration file.
  • What Raspberry I should use: Dicaffeine versions ⇐ 0.5.3 and NDI ⇐ 5.0 should work on Raspberry 3 but don't do it. Raspberry 4 is supported on newer releases and it's noticeably faster and should run smoothly 720p (1080p may have framedrops).
  • Playback or streaming stops after 30 minutes: Probably you're using the old version which requires the license. Current release is distributed for free! Please update your version.

Used software, very important

I am very grateful for many great projects I can freely use in the Dicaffeine. Here's the list:

  • NDI SDK - distributed by Newtek (link, licence)
  • Yuri 2.8 - the great framework for video/audio processing (link, licence)
  • FFmpeg - cross-platform toolbox for video/audio converting and streaming (link, licence).
  • Pistache - C++ REST framework for every request (link, licence)
  • JSON for Modern C++ - everyting you need for handling jsons by nlohmann (link, licence)
  • CLI11 - modern command line parser (link, licence)