From nobody Sun Jun 28 06:40:14 2026 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gp0CR4sm2z6jhSG for ; Sun, 28 Jun 2026 06:40:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gp0CR3dJKz3L2y for ; Sun, 28 Jun 2026 06:40:19 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782628819; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=fF29R5W6B7icyPjVzAvDhXO9pEmieJv+TqGNHymmtxc=; b=q625LbnjZX7zJqnz10fqQhECA4w+6re7wHen/mKOUH79mhWQ/EKeR2ZAUEtJdfeZ/VYQPf zj3XtKmTGGDuTlxPWsTHQjeJGE6Hn7srlBGVN9A3WxOgQt7SVQYw+u/CGLSy/RyRa5VTJA 38aJUbpjbxkfcTiK+JJU+dVtGLocTCKNXVs0N6NCLz8o+YNF/7oSUUsvKJGgrLQJa2ZfQ7 GeEnhGkKFbOg1DTF/uTApr9Fsczpgx10CQU5dMG9ZV3mpT+oxPGlU4CfumUh5xCOI+/0MI Lpmct1ObKi0Rx6+JUM5+ZZXUDl11O0akym/mwwcinfrUvyFABXmyo3rDofcnKA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1782628819; a=rsa-sha256; cv=none; b=KZn0EBO/JxOZV/03/R59/6ABlP+avYJT4/iG/lvU3fIlyZP75XVaGwXhw6zhv6P8NTKZmN nBkSNR+aHUVB2gyczuCMAtUgzEuAdcv/ZsDQ2V49BN9fKJ+uQjpEPOnn81tTlDKnjMq2nQ tCoRL6/tehZLWFB+qOE8pH+VKtRsR7dW2T0IoJp0Y35Xgp00vjqc++GmX0xe+yiB22Z0y5 uMKTMZTVMgXbqjlrugx3AwNBNMIhs7otAx7Y/hIKF2QxmPmu5xuLf7CxwnTiTRiXbgjEmY /yyIcnMQkh7dt7HpuWFS8+IgzEXkyiAqeFdvE4QqozSObfKdpxw8zNX4U5n0ng== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782628819; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=fF29R5W6B7icyPjVzAvDhXO9pEmieJv+TqGNHymmtxc=; b=RR4jKzzebJtXKGoWC8eJ323XtJfZk0T8rQltdb9WGYhrJh+kgyE0b4MLO9996KeT4STmvK R5IJaNOZQx9u1xY/tVmO+dgT3jQ64qDNNrvMXwyYm5/kWcTqhV+54cxXphqF3LvC7CtsmJ i/DJptqUwiUvduaWh59+fO+nhFShq+WMMJLKHWmK5utScpW9MOryKyL+bFImW9dwF0OaKh cSXJtvahul40Ac1HCneFuCdQ/hgl921QAy9kbchVhLMUQxq9dF3ztHw7FWfOo81bUQQxRU iNkQOelWpxAE8O2S/dGjRHQ9t+J1APcwhWL8EfXdaUvxN5hLQbg1bMS8kIXciA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gp0CR2GmCzyDG for ; Sun, 28 Jun 2026 06:40:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 4632b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sun, 28 Jun 2026 06:40:14 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Marcel Weissenbach From: Sergio Carlavilla Delgado Subject: git: 09af4383cf - main - Handbook-multimedia: Replace moc and mplayer List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 09af4383cfb75d13ea9c243110c7e785b84f9c9d Auto-Submitted: auto-generated Date: Sun, 28 Jun 2026 06:40:14 +0000 Message-Id: <6a40c1ce.4632b.1239f6bf@gitrepo.freebsd.org> The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=09af4383cfb75d13ea9c243110c7e785b84f9c9d commit 09af4383cfb75d13ea9c243110c7e785b84f9c9d Author: Marcel Weissenbach AuthorDate: 2026-06-28 06:39:55 +0000 Commit: Sergio Carlavilla Delgado 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