mkv2cast.ui

User interface components for mkv2cast.

Provides both Rich-based and legacy text-based progress displays.

class mkv2cast.ui.LegacyProgressUI(progress: bool = True, bar_width: int = 26)

Bases: object

Fallback progress UI when rich is not available.

render(st: UIState) → None

Render progress line to terminal.

endline() → None

Clear the current progress line.

log(msg: str) → None

Print a log message, clearing progress line first.

inc_ok() → None

Increment success counter.

inc_skipped() → None

Increment skipped counter.

inc_failed() → None

Increment failed counter.

get_stats()

Get current stats.

class mkv2cast.ui.UIState(stage: str, pct: int, cur: int, total: int, base: str, eta: str, speed: str, elapsed: str = '')

Bases: object

State for legacy UI rendering.

stage: str

pct: int

cur: int

total: int

base: str

eta: str

speed: str

elapsed: str = ''

class mkv2cast.ui.RichProgressUI(total_files: int, encode_workers: int, integrity_workers: int)

Bases: object

Rich-based progress UI showing all files with their status.

start()

Start the live display.

stop()

Stop the live display.

register_job(inp: Path, backend: str = '')

Register a new job in waiting state.

start_integrity(worker_id: int, _filename: str, inp: Path)

Start integrity check for a file.

update_integrity(worker_id: int, _stage: str, pct: int, _filename: str, speed: str = '', inp: Path | None = None)

Update integrity progress.

stop_integrity(worker_id: int, inp: Path | None = None)

Mark integrity check as complete.

start_encode(worker_id: int, _filename: str, inp: Path, output_file: str = '')

Start encoding for a file.

update_encode(worker_id: int, _stage: str, pct: int, _filename: str, speed: str = '', inp: Path | None = None, out_ms: int = 0, dur_ms: int = 0)

Update encode progress.

stop_encode(worker_id: int, inp: Path | None = None)

Mark encode as complete.

mark_done(inp: Path, _msg: str = '', final_path: Path | None = None, output_size: int = 0)

Mark a job as successfully completed.

mark_failed(inp: Path, reason: str = '')

Mark a job as failed.

mark_skipped(inp: Path, reason: str = '')

Mark a job as skipped.

log(msg: str)

Add a message to the log.

get_stats() → Tuple[int, int, int, int]

Get current statistics.

class mkv2cast.ui.SimpleRichUI(progress_enabled: bool = True)

Bases: object

Simple Rich-based UI for sequential file processing.

log(msg: str, style: str = '') → None

Print a log message.

log_file_start(inp: Path, output: Path) → None

Log start of file processing.

log_skip(reason: str) → None

Log a skip.

log_error(error: str) → None

Log an error.

log_success(elapsed: float, output_size: int = 0) → None

Log success.

log_compatible() → None

Log file is already compatible.

run_ffmpeg_with_progress(cmd: List[str], stage: str, dur_ms: int = 0, file_idx: int = 1, total_files: int = 1) → Tuple[int, str]

Run ffmpeg command while showing progress.

Returns (return_code, error_message).

print_summary(total_time: float) → None

Print final summary.

inc_ok() → None

Increment success counter.

inc_skipped() → None

Increment skipped counter.

inc_failed() → None

Increment failed counter.

get_stats()

Get current stats.

Modules

legacy_ui	Legacy text-based progress UI for mkv2cast.
rich_ui	Rich-based progress UI for mkv2cast.
simple_rich	Simple Rich-based progress UI for mkv2cast (sequential mode).