Howdy. I'm trying to use this library in my plugin, but the docs are extraordinarily outdated, and even the example plugin - DeluxeMediaPlugin - makes use of classes and methods that have been renamed or even removed entirely.

I appreciate the work you're doing, and I'm very impressed with how far it has come, but it's nearly impossible to use this without spending days or weeks trying to read through this big of a project and figure out how it all works, since the docs and example are so outdated.

Task List:

too lazy to update tasks on Github. To do list can be found in Discord.

Suppose we had two separate threads:

Thread #1: Dithers a specific frame.
Thread #2: Sends the dithered frame data to the clients.

Frame # | What to do:
--------|-------------------------------------
   1    | Thread #1 dithers this frame.
   2    | Thread #2 sends out frame number 1, while Thread #1 dithers frame number 2.
   3    | Thread #2 sends out frame number 2, while Thread #1 dithers frame number 3.
        |

And so on, (chaining domino pattern)

------------------------------------------------------------------------------------------------------

The issue however with one thread is blocking. If the dithered results aren't ready, this means that thread #2 has to be blocked from thread #1 to wait for the send the dithered results to clients. This will significantly slow the video speed and affect the frames being sent per second.

------------------------------------------------------------------------------------------------------

We could split this into more threads based on the user's environment. For example:

Thread #1 ... #2: Dithers a specific frame. (We can dither 2 frames at once since we have 2 threads now instead of just 1)
Thread #3: Sends the dithered frame data to the clients.

Frame # | What to do:
--------|-------------------------------------
   1    | Thread #1 and #2 dithers this frame at the same time.
   2    | Thread #3 sends the dithered frame provided from thread #1/#2. Thread #1/#2 now dithers frame 2. 
        | 

And so on, (chaining domino pattern)

The advantage of having two threads dither is that the result may be faster to receive due to the parallel computations made on the frame dithering. This will mean that the chance of blocking will likely less occur due to how in an ideal environment (where it can support multiple threads running at once at a good pace), it can provide the results faster.

• Since the actual dithering process will be made async/in parallel, encapsulate the result in a Future<int[]>

• Have a FrameSender class (or whatever you wanna call it) with a Queue<Future<int[]>>, I believe a LinkedList is the best option here

• Add the future data to the FrameSender queue orderly before/when the dithering starts (not after it finishes, kinda defeats the purpose of using Futures here), then start the process in parallel. That way, no matter when the frame is processed, since you put them in order as they come in, they will be in order when you retrieve them

• In the sender, so long so it isn't empty, remove() the frame and Futures.getUnchecked(frame) the data and send it, that way it will be sent as soon as it's done (basically blocking the sender thread before sending it until the frame is processed; hopefully, them being processed in parallel will keep them up and overcome any waiting overhead) (the class is from Guava, it just wraps the checked Future#get() exceptions in an unchecked exception/error)

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Repository problems

These problems occurred while renovating this repository. View logs.

• WARN: Package lookup failures

Rate-Limited

These updates are currently rate-limited. Click on a checkbox below to force their creation now.

• Update cimg/openjdk Docker tag to v17.0.9
• Update dependency gradle to v7.6.3
• Update dependency it.unimi.dsi:fastutil to v8.5.12
• Update dependency org.apache.httpcomponents.client5:httpclient5 to v5.2.2
• Update plugin com.github.johnrengelman.shadow to v7.1.2
• Update dependency com.fasterxml.jackson.core:jackson-core to v2.16.0
• Update dependency net.kyori:adventure-api to v4.14.0
• Update dependency net.kyori:adventure-platform-bukkit to v4.3.1
• Update dependency org.jetbrains:annotations to v24.1.0
• Update plugin org.ajoberstar.grgit to v5.2.1
• Update cimg/openjdk Docker tag to v21
• Update dependency com.github.kokorin.jaffree:jaffree to v2023
• Update dependency com.google.guava:guava to v32
• Update dependency me.friwi:jcefmaven to v116
• Update plugin com.github.johnrengelman.shadow to v8
• 🔐 Create all rate-limited PRs at once 🔐

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update dependency com.alibaba:fastjson to v2.0.42
• Update dependency com.github.ben-manes.caffeine:caffeine to v3.1.8
• Update dependency com.github.stefvanschie.inventoryframework:IF to v0.10.12
• Update dependency io.netty:netty-all to v4.1.101.Final
• Update dependency me.friwi:jcefmaven to v109.1.11.1
• Update dependency net.dv8tion:JDA to v5.0.0-beta.18
• Update dependency org.bstats:bstats-bukkit to v3.0.2
• Update plugin xyz.jpenilla.run-paper to v2.2.2
• Update dependency gradle to v8
• Update dependency se.michaelthelin.spotify:spotify-web-api-java to v8
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

• Check this box to trigger a request for Renovate to run again on this repository

Rewriting a ton of stuff. Please don't use the library currently as a big rewrite is in place.

• Video Players
• Audio Playback
• Images (both static and dynamic)
• Youtube/Spotify Playlists
• Using the Web Interface
• Dependency Loading Information

Linux support is currently in progress. I am using JuNest to try and install the packages. Here is my progress so far:

• Install JuNest by using a zip file. (Completed: https://github.com/PulseBeat02/JuNest-Mirror).
• Run a bash script that changes the export paths of JuNest to be proper (so future bash scripts can be executed).
• Run a bash script that installs the proper VLC package downloaded previously.
• Set the proper paths in NativeDiscovery to the JuNest directory.