raydac / ravikoodi-server

A utility that simplifies the exchange of video content and links from your computer to the KODI media server.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

BANNER

License Apache 2.0 Java 17+ PayPal donation YooMoney donation

Changelog

  • 1.1.11 (25-oct-2023)

    • minor fixes
    • added direct URL link open mode for Youtube links
    • updated embedded JDK to 21.0.1+12
    • updated Spring Boot to 3.1.5
  • 1.1.10 (05-jan-2023)

    • minor fixes
    • added AppImage version
    • windows launcher moved from i386 to amd64
    • updated embedded JDK to 19.0.1+11
    • updated Spring Boot to 3.0.1

Full changelog

Introduction

At home I use Raspberry PI 3 (with installed KODI media center) to watch TV-shows and clips. There are number of browser plug-ins to open web links directly on KODI, but I need broadcast some media-content directly from my laptop. KODI supports sharing through Samba etc. but I am too lazy and like one-button solutions. So I decided to write a small easy utility to provide needed one-button way.

How to load and start?

Pre-built versions

OS Download link
Windows Application for Windows amd64 (JRE included)
OSX Application for OSX amd64 (JRE included)
OSX Arm64 Application for OSX aarch64 (JRE included)
Linux Application TAR.GZ for Linux amd64 (JRE included)
Linux Application AppImage for Linux amd64 (JRE included)
Java Application, cross-platform JAR file

You can just load needed archive, unpack in a folder and start its executable file.

Requirements

To be working well, the application requires:

  • min 100 Mb on hard-disk
  • more or less powerful computer (especially for high bitrate screencasting)
  • pre-installed Java 17+ for versions without embedded JDK image
  • pre-installed FFmpeg for screencasting

screenshot with NIMBUS L&F

Application

Some technical details

It is a Spring Boot based application with embedded Jetty web server. For screencast it starts external FFmpeg application and communicate with it through loopback TCP ports. Start of application takes 5-10 seconds and just after start it eats about 300-700 Mb of RAM. For screencasting it makes screenshots so that be carefult in use on weak computers.
scheme

How to build?

It is absolutely free and open-source application (under Apache 2.0 license), I don't ask for any fee for use of it (but you could make some donation and I would be very appreciate for that).

  1. You need Maven to build project
  2. Go to into project folder and call mvn clean install to get compiled JAR, it can be started separately through java -jar <JAR_FILE>
  3. To get release versions, you should use mvn clean install -Ppublish, in the target folder you will find all prepared archives
  4. To get SH version for Linux, you should use mvn clean install -Ppublishsh, in the target folder you will find SH version of the application

Tune KODI

Select network settings ofyour KODI player (its appearance depends on version)
kodi http
Enable Allow remote control via HTTP, select address, port and access credentials.

Processing of Youtube links

There are several ways to open Youtube links.

  1. Just drag and drop a youtube link from browser to the application window.
  2. Open link through menu File->Open Youtube

By default the aplication uses KODI Youtube plugin to open links but since 1.1.11 provided way to open Youtube links as direct URLs. The way can not be recognized as very stable because Youtube can change its API. To activate it, you should select it in Options dialog.
Youtube options

Tune application server

Open options panel Tools -> Options.
option panel

  1. In Web server select in Host your computer's network interface (which is visible for KODI)
  2. In Web server select any free port on your computer in Port (it is better use port number bigger than 1024)
  3. In Kodi enter network address of your KODI machine in Address and KODI listening port in Port
  4. If you use any password protection for access to your KODI, enter needed credentials into Name and Password

After listed steps, your local video server is prepared for broadcasting to KODI.

Play content

  1. Press File tree icon in the button tool bar and select folder contains media-contend through File dialog.
    file tree button
  2. Select needed content in the file tree
    select media file
  3. If you want open the selected media file in the default system player, then click twice the media file or press button
    start in system
  4. Press button Play selected item on KODI to send the media file to internal server and start broadcasting to KODI.
    start on KODI
  5. If you have tuned screencast options (and you have provided FFmpeg) then you can start screencast
    start screencast

About

A utility that simplifies the exchange of video content and links from your computer to the KODI media server.

License:Apache License 2.0


Languages

Language:Java 98.8%Language:Shell 0.7%Language:Go 0.3%Language:Batchfile 0.1%