Date: Sun, 28 Jun 2026 06:40:14 +0000 From: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Marcel Weissenbach <mweissenbach-freebsd@ikaros.space> Subject: git: 09af4383cf - main - Handbook-multimedia: Replace moc and mplayer Message-ID: <6a40c1ce.4632b.1239f6bf@gitrepo.freebsd.org>
index | next in thread | raw e-mail
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]] === SMPlayerhome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a40c1ce.4632b.1239f6bf>