git: 09af4383cf - main - Handbook-multimedia: Replace moc and mplayer

The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=09af4383cfb75d13ea9c243110c7e785b84f9c9d

commit 09af4383cfb75d13ea9c243110c7e785b84f9c9d
Author:     Marcel Weissenbach <mweissenbach-freebsd@ikaros.space>
AuthorDate: 2026-06-28 06:39:55 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2026-06-28 06:39:55 +0000

    Handbook-multimedia: Replace moc and mplayer
---
 .../en/books/handbook/multimedia/_index.adoc       | 78 +++++++++++++++++-----
 1 file changed, 62 insertions(+), 16 deletions(-)

diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc
index be717732ab..f1a56c3f13 100644
--- a/documentation/content/en/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/en/books/handbook/multimedia/_index.adoc
@@ -306,9 +306,9 @@ This section introduces some of the software available from the FreeBSD Ports Co
 | package:multimedia/audacious[]
 | Qt
 
-| MOC (music on console)
+| cmus — C* Music Player
 | GPL 2.0
-| package:audio/moc[]
+| package:audio/cmus[]
 | TUI
 
 |===
@@ -357,18 +357,18 @@ Audacious supports OSS natively, but must be configured in the settings on the A
 ====
 
 [[moc-music-on-console]]
-=== MOC (music on console)
+[[cmus]]
+=== cmus — C* Music Player
 
-MOC (music on console) is a console audio player designed to be powerful and easy to use.
+cmus is a small, fast and powerful console music player for Unix-like operating systems.
 
-MOC plays smoothly, regardless of system or I/O load, because it handles the output buffer in a separate thread.
-It does not cause gaps between files, because the next file to be played is pre-cached while playing the current file.
+Beside various input and output plugins, it has support for CUE sheets, uses Unicode, supports scrobbling (to e.g. last.fm or libre.fm), can run external programs on selected files like tag-editors, can be controlled via UNIX sockets and many more.
 
-To install MOC (music on console), execute:
+To install cmus, execute:
 
 [source,shell]
 ....
-# pkg install moc
+# pkg install cmus
 ....
 
 [[video-ports]]
@@ -381,9 +381,9 @@ This section introduces some of the software available from the FreeBSD Ports Co
 |===
 | Name | License | Package | Toolkit
 
-| MPlayer
+| mpv
 | GPL 2.0
-| package:multimedia/mplayer[]
+| package:multimedia/mpv[]
 | CLI
 
 | SMPlayer
@@ -404,19 +404,65 @@ This section introduces some of the software available from the FreeBSD Ports Co
 |===
 
 [[mplayer]]
-=== MPlayer
+[[mpv]]
+=== mpv
 
-MPlayer is a multimedia player and encoder suite which runs on many platforms and works on the command line.
-It plays a terrific number of different file formats and codecs including popular DivX, XviD, H.264 streams as well as DVD and SVCDs along with many popular audio codecs.
+mpv is a free (as in freedom) media player for the command line. It supports a wide variety of media file formats, audio and video codecs, and subtitle types. mpv can leverage most hardware decoding APIs on all platforms.
 
-To install MPlayer, execute:
+Also targeted towards vidoephile, it has several high quality up-/downscaling algorithms which can also be, like all settings, controlled via profiles. Profiles can be selected via command-line switches or based on conditions like the folder name.
+
+It also supports high quality HDR to SDR conversion with fine-grained control, enabling everyone to enjoy HDR content on any display.
+
+To install mpv, execute:
 
 [source,shell]
 ....
-# pkg install mplayer
+# pkg install mpv
 ....
 
-For examples of how MPlayer works see man:mplayer[1].
+Here is a short sample [filename.]#~/.config/mpv/mpv.conf#
+
+[.programlisting]
+....
+vo=gpu-next<.>
+gpu-context=wayland<.>
+hwdec=auto<.>
+screenshot-jpeg-quality=100
+scale=ewa_lanczos4sharpest<.>
+dscale=ewa_lanczos4sharpest
+
+[TTRPG]<.>
+profile-cond=path:find('ttrpg')<.>
+profile=fast<.>
+save-position-on-quit=yes
+
+[hdr]<.>
+scale=bilinear
+dscale=bilinear
+dither=no
+correct-downscaling=no
+linear-downscaling=no
+sigmoid-upscaling=no
+hdr-compute-peak=yes
+hdr-peak-percentile=99.995
+hdr-contrast-recovery=0.30
+....
+<.> Use the new gpu-next video output. A lot of features need this and/or provide higher quality when enabled
+<.> Wayland users should manually set this when seeing graphical glitches
+<.> Automatically detect if GPU hardware decoding is available and uses it
+<.> Best scaling algorithm. Disable if your hardware is not fast enough and videos start to skip frames
+<.> Example profile for long videos of recorded TTRPG sessions
+<.> Only apply when the path contains ttrpg
+<.> Use the builtin fast profile for lowest possible CPU/GPU usage
+<.> Example profile for users with a slow iGPU that still want to enjoy HDR content
+
+Example how a user with a iGPU would be able to watch HDR content with this sample config
+
+....
+$ mpv --profile=hdr hdr_video.mkv
+....
+
+For more examples on how mpv can be used, consult the mpv reference manual.
 
 [[smplayer]]
 === SMPlayer