-
-
Video Processing Dashboard
-
Real-time status and controls for video transcoding pipeline
+
+
+
Video Processing Dashboard
+
Real-time status and controls for video transcoding pipeline
+
+ <.link
+ navigate={~p"/failures"}
+ class="bg-red-500 hover:bg-red-600 text-white font-semibold py-2 px-4 rounded-lg shadow transition-colors flex items-center gap-2"
+ >
+
+
+ View Failures
+
@@ -439,6 +556,16 @@ defmodule ReencodarrWeb.DashboardV2Live do
Rate: {Reencodarr.Formatters.rate(@analyzer_throughput)} files/s
<% end %>
+ <%= if @analyzer_progress != :none && Map.get(@analyzer_progress, :batch_size) do %>
+
+ Batch: {Map.get(@analyzer_progress, :batch_size)} files
+
+ <% end %>
+ <%= if @analyzer_progress != :none && Map.get(@analyzer_progress, :last_batch_size) do %>
+
+ Last batch: {Map.get(@analyzer_progress, :last_batch_size)} files
+
+ <% end %>
<.pipeline_step
@@ -537,12 +664,11 @@ defmodule ReencodarrWeb.DashboardV2Live do
defp request_current_status do
# Send cast to each producer to broadcast their current status
- Enum.each(@producer_modules, fn {service, producer_module} ->
+ Enum.each(@producer_modules, fn {_service, producer_module} ->
case Process.whereis(producer_module) do
nil ->
- # If process doesn't exist, broadcast stopped event
- event_name = :"#{service}_stopped"
- Events.broadcast_event(event_name, %{})
+ # Process doesn't exist - no broadcast needed (LiveView handles via progress events)
+ :ok
_pid ->
GenServer.cast(producer_module, :broadcast_status)
@@ -580,12 +706,14 @@ defmodule ReencodarrWeb.DashboardV2Live do
do: @service_status_labels[status] || @service_status_labels.unknown
defp request_analyzer_throughput do
- case GenServer.whereis(Reencodarr.Analyzer.Broadway.PerformanceMonitor) do
- nil -> :ok
- pid -> GenServer.cast(pid, {:throughput_request, self()})
- end
+ do_request_analyzer_throughput(
+ GenServer.whereis(Reencodarr.Analyzer.Broadway.PerformanceMonitor)
+ )
end
+ defp do_request_analyzer_throughput(nil), do: :ok
+ defp do_request_analyzer_throughput(pid), do: GenServer.cast(pid, {:throughput_request, self()})
+
defp schedule_periodic_update do
Process.send_after(self(), :update_dashboard_data, 5_000)
end
@@ -599,63 +727,32 @@ defmodule ReencodarrWeb.DashboardV2Live do
end
end
- defp format_service_name(service) do
- service |> String.replace("_", " ") |> String.capitalize()
- end
-
- defp handle_service_control(service, action, socket) do
- service_atom = String.to_existing_atom(service)
-
- case Map.get(@producer_modules, service_atom) do
- nil ->
- {:noreply, put_flash(socket, :error, "Unknown service: #{service}")}
-
- module ->
- execute_service_action(module, action, service, socket)
- end
- end
+ # Queue item data helpers - handle both video and non-video items
+ defp get_item_path(%{video: video}), do: video.path
+ defp get_item_path(%{path: path}), do: path
- defp execute_service_action(module, action, service, socket) do
- case Process.whereis(module) do
- nil ->
- service_name = format_service_name(service)
- {:noreply, put_flash(socket, :info, "#{service_name} service not available")}
+ defp get_item_size(%{video: video}), do: video.size
+ defp get_item_size(%{size: size}), do: size
- _pid ->
- apply(module, action, [])
- service_name = format_service_name(service)
- action_name = if action == :start, do: "started", else: "paused"
- {:noreply, put_flash(socket, :info, "#{service_name} #{action_name}")}
- end
- end
+ defp get_item_bitrate(%{video: video}), do: video.bitrate
+ defp get_item_bitrate(%{bitrate: bitrate}), do: bitrate
- # Queue item data helpers - handle both video and non-video items
- defp get_item_path(item) do
- if Map.has_key?(item, :video), do: item.video.path, else: item.path
- end
+ # Sync service styling helpers
+ defp sync_status_class(%{syncing: true, service_type: service, service: service}),
+ do: "bg-blue-100 text-blue-800 animate-pulse"
- defp get_item_size(item) do
- if Map.has_key?(item, :video), do: item.video.size, else: item.size
- end
+ defp sync_status_class(_assigns),
+ do: "bg-gray-100 text-gray-600"
- defp get_item_bitrate(item) do
- if Map.has_key?(item, :video), do: item.video.bitrate, else: item.bitrate
- end
+ defp sync_status_text(%{syncing: true, service_type: service, service: service}),
+ do: "Syncing"
- # Sync service styling helpers
- defp sync_status_class(assigns) do
- active = assigns.syncing && assigns.service_type == assigns.service
- if active, do: "bg-blue-100 text-blue-800 animate-pulse", else: "bg-gray-100 text-gray-600"
- end
+ defp sync_status_text(_assigns),
+ do: "Ready"
- defp sync_status_text(assigns) do
- active = assigns.syncing && assigns.service_type == assigns.service
- if active, do: "Syncing", else: "Ready"
- end
+ defp sync_button_class(true),
+ do: "bg-gray-300 text-gray-500 cursor-not-allowed"
- defp sync_button_class(syncing) do
- if syncing,
- do: "bg-gray-300 text-gray-500 cursor-not-allowed",
- else: "bg-blue-500 hover:bg-blue-600 text-white"
- end
+ defp sync_button_class(false),
+ do: "bg-blue-500 hover:bg-blue-600 text-white"
end
diff --git a/lib/reencodarr_web/live/failures_live.ex b/lib/reencodarr_web/live/failures_live.ex
index 530c3daf..522b446b 100644
--- a/lib/reencodarr_web/live/failures_live.ex
+++ b/lib/reencodarr_web/live/failures_live.ex
@@ -9,85 +9,66 @@ defmodule ReencodarrWeb.FailuresLive do
- Sorting and searching capabilities
## Architecture Notes:
- - Uses shared LCARS components for consistent UI
+ - Modern Dashboard V2 UI with card-based layout
- Memory optimized with efficient queries
- - Real-time updates for failure state changes
+ - Real-time updates via Events PubSub for failure state changes
"""
use ReencodarrWeb, :live_view
import Ecto.Query
- import ReencodarrWeb.UIHelpers,
- only: [
- filter_button_classes: 2,
- action_button_classes: 0,
- action_button_classes: 2,
- pagination_button_classes: 1,
- filter_tag_classes: 1
- ]
-
require Logger
alias Reencodarr.Core.Parsers
+ alias Reencodarr.Dashboard.Events
alias Reencodarr.Media
alias Reencodarr.Media.SharedQueries
alias Reencodarr.Repo
- import ReencodarrWeb.LcarsComponents
- import Reencodarr.Utils
-
- alias ReencodarrWeb.LiveViewHelpers
-
@impl true
def mount(_params, _session, socket) do
- # Standard LiveView setup
- timezone = get_in(socket.assigns, [:timezone]) || "UTC"
- current_stardate = LiveViewHelpers.calculate_stardate(DateTime.utc_now())
-
- # Schedule stardate updates if connected
- if Phoenix.LiveView.connected?(socket) do
- Process.send_after(self(), :update_stardate, 5000)
- end
-
socket =
socket
- |> assign(:timezone, timezone)
- |> assign(:current_stardate, current_stardate)
|> setup_failures_data()
|> load_failures_data()
+ # Setup subscriptions and periodic updates if connected
+ if connected?(socket) do
+ # Subscribe to dashboard events for real-time updates
+ Phoenix.PubSub.subscribe(Reencodarr.PubSub, Events.channel())
+ # Start periodic data refresh
+ schedule_periodic_update()
+ end
+
{:ok, socket}
end
@impl true
- def handle_info(:update_stardate, socket) do
- # Update stardate and schedule next update
- Process.send_after(self(), :update_stardate, 5000)
-
- socket =
- assign(
- socket,
- :current_stardate,
- LiveViewHelpers.calculate_stardate(DateTime.utc_now())
- )
-
+ def handle_info(:update_failures_data, socket) do
+ # Reload failures data periodically
+ schedule_periodic_update()
+ socket = load_failures_data(socket)
{:noreply, socket}
end
+ # Handle events that might affect failures (video state changes, encoding completion, etc.)
@impl true
- def handle_event("set_timezone", %{"timezone" => tz}, socket) do
- require Logger
- Logger.debug("Setting timezone to #{tz}")
- socket = assign(socket, :timezone, tz)
+ def handle_info({event, _data}, socket)
+ when event in [
+ :encoding_completed,
+ :crf_search_completed,
+ :analyzer_completed,
+ :video_failed
+ ] do
+ # Reload failures when pipeline events occur that might change failure state
+ socket = load_failures_data(socket)
{:noreply, socket}
end
+ # Catch-all for other Events we don't need to handle
@impl true
- def handle_event("timezone_change", %{"tz" => tz}, socket) do
- require Logger
- Logger.debug("Setting timezone to #{tz}")
- socket = assign(socket, :timezone, tz)
+ def handle_info({_event, _data}, socket) do
{:noreply, socket}
end
@@ -204,598 +185,464 @@ defmodule ReencodarrWeb.FailuresLive do
@impl true
def render(assigns) do
~H"""
-
-
-
-
-
-
-
-
-
- REENCODARR OPERATIONS - FAILURES ANALYSIS
-
+
+
+
+
+
+
Failure Analysis Dashboard
+
Monitor and manage failed video processing operations
+
+ <.link
+ navigate={~p"/"}
+ class="bg-blue-500 hover:bg-blue-600 text-white font-semibold py-2 px-4 rounded-lg shadow transition-colors flex items-center gap-2"
+ >
+
+
+ Back to Dashboard
+
-
-
-
- <.lcars_navigation current_page={:failures} />
-
-
-
-
-
-
FAILURES SUMMARY
-
-
-
FAILED VIDEOS
-
{length(@failed_videos)}
+
+
+
+
Failure Summary
+
+
+
Failed Videos
+
{length(@failed_videos)}
+
Total failures
-
-
FAILURE PATTERNS
-
{length(@failure_patterns)}
+
+
Failure Patterns
+
{length(@failure_patterns)}
+
Unique patterns
-
-
RECENT FAILURES
-
{@failure_stats.recent_count || 0}
+
+
Recent Failures
+
{@failure_stats.recent_count || 0}
+
Last 7 days
-
-
-
-
FAILURE ANALYSIS CONTROLS
-
-
-
-
-
-
-
-
-
-
STAGE:
-
- ALL
-
-
- ANALYSIS
-
-
- CRF SEARCH
-
-
- ENCODING
-
-
- POST-PROCESS
-
+
+
+
Filters & Search
+
+
+
+
+
+
+
+
+
+
+
Stage:
+
+
+ All
+
+
+ Analysis
+
+
+ CRF Search
+
+
+ Encoding
+
+
+ Post-Process
+
+
-
-
TYPE:
-
- ALL
-
-
- FILE ACCESS
-
-
- PROCESS
-
-
- TIMEOUT
-
-
- CODEC
-
+
+
Type:
+
+
+ All
+
+
+ File Access
+
+
+ Process
+
+
+ Timeout
+
+
+ Codec
+
+
<%= if @failure_filter != "all" or @category_filter != "all" or @search_term != "" do %>
-
-
-
ACTIVE FILTERS:
+
+
+ Active filters:
<%= if @failure_filter != "all" do %>
-
- Stage: {String.upcase(@failure_filter)}
+
+ Stage: {@failure_filter}
<% end %>
<%= if @category_filter != "all" do %>
-
- Type: {String.upcase(@category_filter)}
+
+ Type: {@category_filter}
<% end %>
<%= if @search_term != "" do %>
- Search: "{@search_term}"
+
+ Search: "{@search_term}"
+
<% end %>
-
- CLEAR ALL
+
+ Clear All
<% end %>
-
-
-
-
FAILED VIDEOS
+
+
+
+
+
Failed Videos
+
+ Showing {@total_count} {if @total_count == 1, do: "failure", else: "failures"}
+
<%= if @failed_videos == [] do %>
-
-
✅
-
NO FAILURES DETECTED
-
+
+
✅
+
No Failures Found
+
<%= if @search_term != "" do %>
No failed videos match your search criteria
<% else %>
All videos are processing successfully
<% end %>
-
+
<% else %>
-
-
-
-
- <%= for video <- @failed_videos do %>
-
-
-
#{video.id}
-
-
- RETRY
-
-
- {if video.id in @expanded_details, do: "HIDE", else: "DETAILS"}
-
+
+
+ <%= for video <- @failed_videos do %>
+
+
+
+
+
+ ID: {video.id}
+ <%= if video.service_type do %>
+
+ {video.service_type}
+
+ <% end %>
-
-
-
-
+
{Path.basename(video.path)}
-
-
+
+
{Path.dirname(video.path)}
-
+
-
- <%= if video.size do %>
-
- {Reencodarr.Formatters.file_size(video.size)}
-
- <% end %>
- <%= if video.video_codecs && length(video.video_codecs) > 0 do %>
-
- V: {format_codecs(video.video_codecs)}
-
- <% end %>
- <%= if video.audio_codecs && length(video.audio_codecs) > 0 do %>
-
- A: {format_codecs(video.audio_codecs)}
-
- <% end %>
+
+
+ Retry
+
+
+ {if video.id in @expanded_details, do: "Hide", else: "Details"}
+
-
- <%= case Map.get(@video_failures, video.id) do %>
- <% failures when is_list(failures) and length(failures) > 0 -> %>
-
- <%= for failure <- Enum.take(failures, 1) do %>
-
" text-xs"}>
-
- {failure.failure_stage}/{failure.failure_category}
-
-
{failure.failure_message}
- <%= if has_command_details?(failure.system_context) do %>
-
- 💻 Command details available
-
- <% end %>
-
- <% end %>
- <%= if length(failures) > 1 do %>
-
- +{length(failures) - 1} more failures
-
- <% end %>
-
- <% _ -> %>
-
No specific failures recorded
+
+
+
+
+ <%= if video.size do %>
+
+ {Reencodarr.Formatters.file_size(video.size)}
+
<% end %>
-
-
- <%= if video.id in @expanded_details do %>
-
-
-
-
VIDEO DETAILS
-
-
- Bitrate: {if video.bitrate,
- do: "#{video.bitrate} bps",
- else: "Unknown"}
-
-
- Duration: {Reencodarr.Formatters.duration_minutes(
- video.duration
- )}
-
-
- Resolution: {Reencodarr.Formatters.resolution(
- video.width,
- video.height
- )}
-
-
Service: {video.service_type}
-
-
- <%= case Map.get(@video_failures, video.id) do %>
- <% failures when is_list(failures) and length(failures) > 0 -> %>
-
-
- ALL FAILURES
-
-
- <%= for failure <- failures do %>
-
-
- {failure.failure_stage} / {failure.failure_category}
- {if failure.failure_code, do: " (#{failure.failure_code})"}
-
-
{failure.failure_message}
-
-
- <%= if Map.get(failure.system_context || %{}, "command") do %>
-
-
- COMMAND:
-
-
- {Map.get(failure.system_context, "command")}
-
-
- <% end %>
-
- <%= if has_command_details?(failure.system_context) do %>
-
-
- COMMAND OUTPUT:
-
-
- {format_command_output(
- Map.get(failure.system_context, "full_output")
- )}
-
-
- <% end %>
-
-
- {Calendar.strftime(failure.inserted_at, "%m/%d %H:%M")}
-
-
- <% end %>
-
-
- <% _ -> %>
-
- No detailed failure information available
-
- <% end %>
-
-
+ <%= if video.duration do %>
+
+ {Reencodarr.Formatters.duration_minutes(video.duration)}
+
+ <% end %>
+ <%= if video.width && video.height do %>
+
+ {Reencodarr.Formatters.resolution(video.width, video.height)}
+
+ <% end %>
+ <%= if video.video_codecs && length(video.video_codecs) > 0 do %>
+
+ V: {format_codecs(video.video_codecs)}
+
+ <% end %>
+ <%= if video.audio_codecs && length(video.audio_codecs) > 0 do %>
+
+ A: {format_codecs(video.audio_codecs)}
+
<% end %>
- <% end %>
-
-
-
-
-
-
-
-
- ID
- FILE
- SIZE
- CODECS
- LATEST FAILURE
- ACTIONS
-
-
-
- <%= for video <- @failed_videos do %>
-
- {video.id}
-
-
- {Path.basename(video.path)}
-
-
- .../{video.path |> String.split("/") |> Enum.take(-2) |> Enum.join("/")}
+
+
+ <%= case Map.get(@video_failures, video.id) do %>
+ <% failures when is_list(failures) and length(failures) > 0 -> %>
+ <% latest_failure = List.first(failures) %>
+
+
+
+ {latest_failure.failure_stage} / {latest_failure.failure_category}
+ <%= if latest_failure.failure_code do %>
+ ({latest_failure.failure_code})
+ <% end %>
+
+ <%= if has_command_details?(latest_failure.system_context) do %>
+
+ 💻
+
+ <% end %>
-
-
- <%= if video.size do %>
- {Reencodarr.Formatters.file_size(video.size)}
- <% else %>
- Unknown
+ {latest_failure.failure_message}
+ <%= if length(failures) > 1 do %>
+
+ +{length(failures) - 1} additional {if length(failures) == 2,
+ do: "failure",
+ else: "failures"}
+
<% end %>
-
-
-
+
+ <% _ -> %>
+
+
No specific failure information recorded
+
+
+
+
Technical Details
+
- V: {format_codecs(video.video_codecs)}
+ Bitrate:
+
+ {Reencodarr.Formatters.bitrate(video.bitrate)}
+
- A: {format_codecs(video.audio_codecs)}
+ Duration:
+
+ {Reencodarr.Formatters.duration_minutes(video.duration)}
+
+
+
+ Resolution:
+
+ {Reencodarr.Formatters.resolution(video.width, video.height)}
+
+
+
+ Service:
+ {video.service_type || "Unknown"}
-
-
- <%= case Map.get(@video_failures, video.id) do %>
- <% failures when is_list(failures) and length(failures) > 0 -> %>
- <% latest_failure = List.first(failures) %>
- " text-xs"}>
-
- {latest_failure.failure_stage}/{latest_failure.failure_category}
-
-
- {latest_failure.failure_message}
-
- <%= if has_command_details?(latest_failure.system_context) do %>
-
- 💻 Command details available
+
+
+
+ <%= case Map.get(@video_failures, video.id) do %>
+ <% failures when is_list(failures) and length(failures) > 0 -> %>
+
+
+ All Failures ({length(failures)})
+
+
+ <%= for failure <- failures do %>
+
+
+
+ {failure.failure_stage} / {failure.failure_category}
+ <%= if failure.failure_code do %>
+ ({failure.failure_code})
+ <% end %>
+
+
+ {Calendar.strftime(failure.inserted_at, "%m/%d %H:%M")}
+
+
+
{failure.failure_message}
+
+ <%= if Map.get(failure.system_context || %{}, "command") do %>
+
+
+ Command:
+
+
+ {Map.get(failure.system_context, "command")}
+
+
+ <% end %>
+
+ <%= if has_command_details?(failure.system_context) do %>
+
+
+ Output:
+
+
+
{format_command_output(
+ Map.get(failure.system_context, "full_output")
+ )}
+
+
+ <% end %>
<% end %>
- <%= if length(failures) > 1 do %>
-
- +{length(failures) - 1} more
-
- <% end %>
- <% _ -> %>
-
No specific failures recorded
- <% end %>
-
-
-
-
- RETRY
-
-
- {if video.id in @expanded_details, do: "HIDE", else: "DETAILS"}
-
-
-
-
- <%= if video.id in @expanded_details do %>
-
-
-
-
-
- VIDEO DETAILS
-
-
-
- Bitrate: {Reencodarr.Formatters.bitrate(
- video.bitrate
- )}
-
-
- Duration: {Reencodarr.Formatters.duration_minutes(
- video.duration
- )}
-
-
- Resolution: {Reencodarr.Formatters.resolution(
- video.width,
- video.height
- )}
-
-
Service: {video.service_type}
-
-
- <%= case Map.get(@video_failures, video.id) do %>
- <% failures when is_list(failures) and length(failures) > 0 -> %>
-
-
- FAILURE DETAILS
-
-
- <%= for failure <- failures do %>
-
-
- {failure.failure_stage} / {failure.failure_category}
- {if failure.failure_code, do: " (#{failure.failure_code})"}
-
-
{failure.failure_message}
-
-
- <%= if Map.get(failure.system_context || %{}, "command") do %>
-
-
- EXECUTED COMMAND:
-
-
- {Map.get(failure.system_context, "command")}
-
-
- <% end %>
-
- <%= if has_command_details?(failure.system_context) do %>
-
-
- FULL COMMAND OUTPUT:
-
-
- {format_command_output(
- Map.get(failure.system_context, "full_output")
- )}
-
-
- <% end %>
-
-
- {Calendar.strftime(
- failure.inserted_at,
- "%Y-%m-%d %H:%M:%S UTC"
- )}
-
-
- <% end %>
-
-
- <% _ -> %>
-
- No detailed failure information available
-
- <% end %>
-
- <% end %>
+ <% _ -> %>
+
+ No detailed failure information available
+
+ <% end %>
+
<% end %>
-
-
+
+ <% end %>
<%= if @total_pages > 1 do %>
-
-
-
- Page {@page} of {@total_pages}
+
+
+
+ Page {@page}
+ of {@total_pages}
-
<%= if @page > 1 do %>
««
- <% end %>
-
-
- <%= if @page > 1 do %>
‹
<% end %>
-
-
+
<%= for page_num <- pagination_range(@page, @total_pages) do %>
<% end %>
-
-
+
<%= if @page < @total_pages do %>
›
- <% end %>
-
-
- <%= if @page < @total_pages do %>
»»
@@ -809,44 +656,32 @@ defmodule ReencodarrWeb.FailuresLive do
<%= if length(@failure_patterns) > 0 do %>
-
-
-
COMMON FAILURE PATTERNS
-
-
-
- <%= for pattern <- @failure_patterns do %>
-
-
-
-
- {pattern.stage}/{pattern.category}
- {if pattern.code, do: "(#{pattern.code})"}
-
-
{pattern.sample_message}
+
+
Common Failure Patterns
+
+ <%= for pattern <- @failure_patterns do %>
+
+
+
+
+ {pattern.stage}/{pattern.category}
+ {if pattern.code, do: " (#{pattern.code})"}
-
-
{pattern.count} occurrences
-
- Latest: {Calendar.strftime(pattern.latest_occurrence, "%m/%d %H:%M")}
-
+
{pattern.sample_message}
+
+
+
{pattern.count}
+
occurrences
+
+ Latest: {Calendar.strftime(pattern.latest_occurrence, "%m/%d %H:%M")}
- <% end %>
-
+
+ <% end %>
<% end %>
-
-
-
-
-
- STARDATE {@current_stardate}
-
-
-
"""
@@ -1031,7 +866,7 @@ defmodule ReencodarrWeb.FailuresLive do
Enum.to_list(start_page..end_page)
end
- defp format_command_output(output) when is_non_empty_binary(output) do
+ defp format_command_output(output) when is_binary(output) and output != "" do
# Clean up common command output formatting issues
output
# Windows line endings
@@ -1049,12 +884,8 @@ defmodule ReencodarrWeb.FailuresLive do
!is_nil(command) or output != ""
end
- # CSS helper functions
- # Helper functions use UIHelpers directly
- import ReencodarrWeb.UIHelpers,
- only: [
- filter_button_classes: 2,
- action_button_classes: 0,
- pagination_button_classes: 1
- ]
+ # Private helper to schedule periodic data updates
+ defp schedule_periodic_update do
+ Process.send_after(self(), :update_failures_data, 5_000)
+ end
end
diff --git a/lib/reencodarr_web/live/rules_live.ex b/lib/reencodarr_web/live/rules_live.ex
index 8cd420e5..15c00f29 100644
--- a/lib/reencodarr_web/live/rules_live.ex
+++ b/lib/reencodarr_web/live/rules_live.ex
@@ -7,25 +7,21 @@ defmodule ReencodarrWeb.RulesLive do
- Example configurations
- Parameter descriptions
- Video format guidelines
+
+ ## Architecture Notes:
+ - Modern Dashboard V2 UI with card-based layout
+ - Section-based navigation for easy browsing
+ - Real-time content switching without page reload
"""
use ReencodarrWeb, :live_view
require Logger
- import ReencodarrWeb.LcarsComponents
-
- alias ReencodarrWeb.LiveViewHelpers
@impl true
def mount(_params, _session, socket) do
- # Standard LiveView setup
- timezone = get_in(socket.assigns, [:timezone]) || "UTC"
- current_stardate = LiveViewHelpers.calculate_stardate(DateTime.utc_now())
-
socket =
socket
- |> assign(:timezone, timezone)
- |> assign(:current_stardate, current_stardate)
|> assign(:selected_section, :overview)
{:ok, socket}
@@ -37,105 +33,131 @@ defmodule ReencodarrWeb.RulesLive do
{:noreply, assign(socket, :selected_section, section_atom)}
end
- @impl true
- def handle_event("set_timezone", %{"timezone" => _tz}, socket) do
- # For the rules page, we don't need to handle timezone changes
- # but we need to handle the event to prevent crashes
- {:noreply, socket}
- end
-
@impl true
def render(assigns) do
~H"""
- <.lcars_page_frame
- title="REENCODARR OPERATIONS - ENCODING RULES"
- current_page={:rules}
- current_stardate={@current_stardate}
- >
-
-
-
- <.rules_navigation selected_section={@selected_section} />
+
+
+
+
+
+
Encoding Rules Documentation
+
+ Learn how Reencodarr automatically optimizes video encoding
+
+
+ <.link
+ navigate={~p"/"}
+ class="bg-blue-600 hover:bg-blue-700 text-white font-semibold py-2 px-4 rounded-lg shadow transition-colors flex items-center gap-2 self-start"
+ >
+
+
+ Back to Dashboard
+
-
+
+
+
+
+ <.rules_navigation selected_section={@selected_section} />
+
+
-
- <%= case @selected_section do %>
- <% :overview -> %>
- <.rules_overview />
- <% :video_rules -> %>
- <.video_rules_section />
- <% :audio_rules -> %>
- <.audio_rules_section />
- <% :hdr_support -> %>
- <.hdr_rules_section />
- <% :resolution_scaling -> %>
- <.resolution_rules_section />
- <% :helper_rules -> %>
- <.helper_rules_section />
- <% :crf_search -> %>
- <.crf_search_section />
- <% :command_examples -> %>
- <.command_examples_section />
- <% end %>
+
+ <%= case @selected_section do %>
+ <% :overview -> %>
+ <.rules_overview />
+ <% :video_rules -> %>
+ <.video_rules_section />
+ <% :audio_rules -> %>
+ <.audio_rules_section />
+ <% :hdr_support -> %>
+ <.hdr_rules_section />
+ <% :resolution_scaling -> %>
+ <.resolution_rules_section />
+ <% :helper_rules -> %>
+ <.helper_rules_section />
+ <% :crf_search -> %>
+ <.crf_search_section />
+ <% :command_examples -> %>
+ <.command_examples_section />
+ <% end %>
+
-
+
"""
end
# Navigation Component
defp rules_navigation(assigns) do
~H"""
-
- <.section_nav_button
- section={:overview}
- selected={@selected_section}
- label="OVERVIEW"
- description="How rules work"
- />
- <.section_nav_button
- section={:video_rules}
- selected={@selected_section}
- label="VIDEO ENCODING"
- description="AV1 parameters"
- />
- <.section_nav_button
- section={:audio_rules}
- selected={@selected_section}
- label="AUDIO ENCODING"
- description="Opus transcoding"
- />
- <.section_nav_button
- section={:hdr_support}
- selected={@selected_section}
- label="HDR SUPPORT"
- description="High Dynamic Range"
- />
- <.section_nav_button
- section={:resolution_scaling}
- selected={@selected_section}
- label="RESOLUTION"
- description="4K+ handling"
- />
- <.section_nav_button
- section={:helper_rules}
- selected={@selected_section}
- label="HELPER RULES"
- description="CUDA & Grain"
- />
- <.section_nav_button
- section={:crf_search}
- selected={@selected_section}
- label="CRF SEARCH"
- description="Quality testing"
- />
- <.section_nav_button
- section={:command_examples}
- selected={@selected_section}
- label="EXAMPLES"
- description="Real commands"
- />
+
+
Navigation
+
+ <.section_nav_button
+ section={:overview}
+ selected={@selected_section}
+ label="Overview"
+ description="How rules work"
+ icon="📚"
+ />
+ <.section_nav_button
+ section={:video_rules}
+ selected={@selected_section}
+ label="Video Encoding"
+ description="AV1 parameters"
+ icon="🎬"
+ />
+ <.section_nav_button
+ section={:audio_rules}
+ selected={@selected_section}
+ label="Audio Encoding"
+ description="Opus transcoding"
+ icon="🔊"
+ />
+ <.section_nav_button
+ section={:hdr_support}
+ selected={@selected_section}
+ label="HDR Support"
+ description="High Dynamic Range"
+ icon="🌈"
+ />
+ <.section_nav_button
+ section={:resolution_scaling}
+ selected={@selected_section}
+ label="Resolution"
+ description="4K+ handling"
+ icon="📏"
+ />
+ <.section_nav_button
+ section={:helper_rules}
+ selected={@selected_section}
+ label="Helper Rules"
+ description="CUDA & Grain"
+ icon="⚙️"
+ />
+ <.section_nav_button
+ section={:crf_search}
+ selected={@selected_section}
+ label="CRF Search"
+ description="Quality testing"
+ icon="🔍"
+ />
+ <.section_nav_button
+ section={:command_examples}
+ selected={@selected_section}
+ label="Examples"
+ description="Real commands"
+ icon="💻"
+ />
+
"""
end
@@ -150,15 +172,22 @@ defmodule ReencodarrWeb.RulesLive do
phx-click="select_section"
phx-value-section={@section}
class={[
- "w-full text-left p-3 rounded border transition-colors",
+ "w-full text-left p-3 rounded-lg border transition-colors",
if(@active,
- do: "bg-orange-600 border-orange-500 text-white",
- else: "bg-gray-800 border-gray-600 text-orange-300 hover:bg-gray-700"
+ do: "bg-blue-600 border-blue-600 text-white shadow-md",
+ else: "bg-white border-gray-300 text-gray-700 hover:bg-gray-50 hover:border-gray-400"
)
]}
>
-
{@label}
-
{@description}
+
+
{@icon}
+
+
{@label}
+
+ {@description}
+
+
+
"""
end
@@ -168,8 +197,11 @@ defmodule ReencodarrWeb.RulesLive do
defp rules_overview(assigns) do
~H"""
- <.lcars_panel title="ENCODING RULES OVERVIEW" color="orange">
-
+
+
+ 📚 Encoding Rules Overview
+
+
Reencodarr uses a sophisticated rule system to determine optimal encoding parameters
for each video file. The rules analyze media properties and apply appropriate settings
@@ -177,9 +209,9 @@ defmodule ReencodarrWeb.RulesLive do
-
-
🎬 VIDEO ANALYSIS
-
+
+
🎬 VIDEO ANALYSIS
+
• Resolution detection (4K, 1080p, etc.)
• HDR format identification
• Dynamic range optimization
@@ -187,9 +219,9 @@ defmodule ReencodarrWeb.RulesLive do
-
🔊 AUDIO PROCESSING
-
+
+
🔊 AUDIO PROCESSING
+
• Channel configuration analysis
• Opus bitrate optimization
• Atmos preservation rules
@@ -198,52 +230,62 @@ defmodule ReencodarrWeb.RulesLive do
-
+
- <.lcars_panel title="RULE PRIORITY SYSTEM" color="blue">
-
+
+
+ 🎯 Rule Priority System
+
+
Rules are applied in a specific order with different rules for different contexts:
-
-
CRF Search Context
-
+
+
CRF Search Context
+
- 1. HDR Rule: hdr/1
- - HDR and SDR tuning parameters
+ 1. HDR Rule:
+ hdr/1 - HDR and SDR tuning parameters
- 2. Resolution Rule:
- resolution/1 - 4K+ downscaling to 1080p
+ 2. Resolution Rule:
+ resolution/1 - 4K+ downscaling to 1080p
- 3. Video Rule: video/1
- - Pixel format standardization
+ 3. Video Rule:
+ video/1 - Pixel format standardization
-
+
+
Encoding Context (includes all CRF rules plus)
-
+
- 0. Audio Rule: audio/1
+ 0. Audio Rule:
+ audio/1
- Opus transcoding (encoding only)
1-3. Same as CRF Search...
-
Additional Helper Rules
-
- cuda/1 - Hardware acceleration (manual application)grain/2 - Film grain synthesis for SDR content
+
Additional Helper Rules
+
+
+ cuda/1
+ - Hardware acceleration (manual application)
+
+
+ grain/2
+ - Film grain synthesis for SDR content
+
"""
end
@@ -251,27 +293,30 @@ defmodule ReencodarrWeb.RulesLive do
defp video_rules_section(assigns) do
~H"""
- <.lcars_panel title="VIDEO ENCODING STANDARDS" color="orange">
-
+
+
+ 🎬 VIDEO ENCODING STANDARDS
+
+
Reencodarr enforces consistent video quality standards across all your media by automatically
applying the best pixel format for modern AV1 encoding.
-
-
🎯 What Happens to Your Videos
+
+
🎯 What Happens to Your Videos
-
-
Pixel Format Standardization
+
+
Pixel Format Standardization
Every video gets converted to 10-bit YUV 4:2:0
format, regardless of its original format.
-
+
-
Benefits:
+
Benefits:
• Smoother color gradients
• Reduced color banding
@@ -281,7 +326,7 @@ defmodule ReencodarrWeb.RulesLive do
-
Compatibility:
+
Compatibility:
• Works on all modern devices
• Supported by streaming platforms
@@ -293,25 +338,25 @@ defmodule ReencodarrWeb.RulesLive do
-
-
🔧 Technical Deep Dive
-
+
+
🔧 Technical Deep Dive
+
-
Why 10-bit over 8-bit?
+
Why 10-bit over 8-bit?
10-bit provides 1,024 shades per color channel instead of 256, resulting in smoother transitions and more accurate colors, especially noticeable in dark scenes and gradients.
-
YUV 4:2:0 Explained
+
YUV 4:2:0 Explained
This is the standard way video is stored - full resolution for brightness (luma) but reduced resolution for color information (chroma). Your eyes are more sensitive to brightness than color, so this saves space without visible quality loss.
-
Universal Application
+
Universal Application
This rule applies to ALL videos, whether they're 720p, 1080p, 4K, HDR, or SDR. It ensures your entire library has consistent, high-quality encoding.
@@ -319,11 +364,11 @@ defmodule ReencodarrWeb.RulesLive do
-
-
📋 Real-World Examples
+
+
📋 Real-World Examples
-
-
Example 1: Old DVD Rip
+
+
Example 1: Old DVD Rip
Input: 8-bit YUV 4:2:0 (standard DVD)
@@ -332,13 +377,13 @@ defmodule ReencodarrWeb.RulesLive do
Output: 10-bit YUV 4:2:0 (upgraded for AV1)
-
+
Even old content gets the modern pixel format treatment for better compression and future compatibility.
-
-
Example 2: High-End 4K Blu-ray
+
+
Example 2: High-End 4K Blu-ray
Input: 10-bit YUV 4:2:0 (already optimal)
@@ -347,13 +392,13 @@ defmodule ReencodarrWeb.RulesLive do
Output: 10-bit YUV 4:2:0 (maintained)
-
+
Already-optimal content stays optimal, ensuring no degradation during re-encoding.
-
-
Example 3: Web/Streaming Source
+
+
Example 3: Web/Streaming Source
Input: 8-bit YUV 4:2:0 (typical streaming)
@@ -362,14 +407,14 @@ defmodule ReencodarrWeb.RulesLive do
Output: 10-bit YUV 4:2:0 (enhanced)
-
+
Streaming content gets upgraded to broadcast/disc quality standards for your personal library.
-
+
"""
end
@@ -377,57 +422,60 @@ defmodule ReencodarrWeb.RulesLive do
defp audio_rules_section(assigns) do
~H"""
- <.lcars_panel title="SMART AUDIO TRANSCODING" color="purple">
-
+
+
+ 🔊 SMART AUDIO TRANSCODING
+
+
Reencodarr intelligently decides when and how to convert your audio to the modern Opus codec,
which provides excellent quality at smaller file sizes.
-
-
🧠 Smart Decision Making
+
+
🧠 Smart Decision Making
-
-
When Audio is LEFT ALONE:
-
+
+
When Audio is LEFT ALONE:
+
🎭 Dolby Atmos content - Preserves object-based 3D audio
🎵 Already Opus - No need to re-encode optimal format
❓ Missing metadata - Safety check when info is unavailable
-
When Audio Gets CONVERTED:
-
+
+
When Audio Gets CONVERTED:
+
Everything else gets transcoded to Opus with channel-specific bitrates for optimal quality and file size.
-
-
🔊 Opus Bitrate Guide
+
+
🔊 Opus Bitrate Guide
-
- Audio Layout
- Channels
- Bitrate
- Notes
+
+ Audio Layout
+ Channels
+ Bitrate
+ Notes
-
-
+
+
Mono
1
- 64 kbps
+ 64 kbps
Perfect for speech
-
+
Stereo
2
- 96 kbps
+ 96 kbps
Excellent for music
@@ -436,22 +484,22 @@ defmodule ReencodarrWeb.RulesLive do
128 kbps
⭐ Upmixed to 5.1!
-
+
5.1 Surround
6
- 384 kbps
+ 384 kbps
Theater experience
-
+
7.1 Surround
8
- 510 kbps
+ 510 kbps
Premium surround
-
+
High Channel Count
9+
- 510 kbps
+ 510 kbps
Capped maximum
@@ -459,11 +507,11 @@ defmodule ReencodarrWeb.RulesLive do
-
-
🎯 Special Features
-
+
+
🎯 Special Features
+
-
⭐ 3-Channel Upmix (Opus Fix)
+
⭐ 3-Channel Upmix (Opus Fix)
When Reencodarr finds 3-channel audio (like 2.1 or 3.0), it automatically upgrades it to 6-channel 5.1 surround sound. This is necessary because Opus has encoding issues with 3-channel audio that can cause distortion or playback problems. The upmix creates a proper 6-channel layout with correct channel mapping rather than trying to preserve the problematic 3-channel configuration.
@@ -577,7 +625,7 @@ defmodule ReencodarrWeb.RulesLive do
-
+
- <.lcars_panel title="HDR & SDR OPTIMIZATION" color="cyan">
-
+
+
+ 🌈 HDR & SDR OPTIMIZATION
+
+
Reencodarr automatically detects and applies the best encoding settings for both High Dynamic Range (HDR)
and Standard Dynamic Range (SDR) content to preserve their unique characteristics.
@@ -772,7 +823,7 @@ defmodule ReencodarrWeb.RulesLive do
-
+
- <.lcars_panel title="4K+ DOWNSCALING" color="green">
-
+
+
+ 📏 4K+ DOWNSCALING
+
+
Reencodarr automatically downscales 4K and higher resolution content to 1080p for optimal
balance of quality, file size, and encoding speed.
@@ -968,7 +1022,7 @@ defmodule ReencodarrWeb.RulesLive do
-
+
- <.lcars_panel title="OPTIONAL ENHANCEMENT FEATURES" color="indigo">
-
+
+
+ ⚙️ OPTIONAL ENHANCEMENT FEATURES
+
+
These optional features can be manually enabled for specific hardware configurations
or content enhancement needs.
@@ -1099,7 +1156,7 @@ defmodule ReencodarrWeb.RulesLive do
-
+
- <.lcars_panel title="CRF SEARCH EXPLAINED" color="teal">
-
+
+
+ 🔍 CRF SEARCH EXPLAINED
+
+
Before encoding your videos, Reencodarr uses CRF (Constant Rate Factor) Search to find the perfect quality setting.
This ensures optimal file sizes while maintaining excellent visual quality.
@@ -1366,7 +1426,7 @@ defmodule ReencodarrWeb.RulesLive do
-
+
- <.lcars_panel title="REAL COMMAND EXAMPLES" color="yellow">
-
+
+
+ 💻 REAL COMMAND EXAMPLES
+
+
See how the rules translate into actual ab-av1 encoding commands for different video types.
These examples show the final commands after CRF search has determined the optimal quality setting.
@@ -1511,9 +1574,12 @@ defmodule ReencodarrWeb.RulesLive do
-
+
+
+ 📚 PARAMETER REFERENCE
+
@@ -1536,7 +1602,7 @@ defmodule ReencodarrWeb.RulesLive do
-
+