Clear Fraction

Third-party repository for Clear Linux optimized for performance

Features:

• FFmpeg, Mpv, Gstreamer, VSCodium, Brave and more applications

• popular media codecs support including ffmpeg with SVT-AV1, x264, x265, AAC and more encoders/decoders

• open source workflow and build logs

Table of Contents

• How to enable the repository

• Install software

• How to get updates

• Repair

• Video playback in Firefox

• Documentation

  • How it works
  • How to build software using Clear Fraction libraries like x264, x265 or CUDA

• Donate

How to enable the repository

• note 1: for old CPUs without AVX2 support use the https://v2clearfraction.vercel.app/update, you can fix it anytime in the swupd config /opt/3rd-party/repo.ini.
• note 2: do not install mpv from Clear repository, strange things will happen. Enabling hardware acceleration may be a good idea.
• note 3: the "bundle not found" error caused by the format bump - check this issue.

sudo swupd 3rd-party add clearfraction https://clearfraction.vercel.app/update
sudo mkdir -p /etc/environment.d /etc/profile.d
sudo tee -a /etc/environment.d/10-cf.conf << EOF
PATH=/usr/bin/haswell:/usr/bin:/usr/local/bin:/opt/3rd-party/bundles/clearfraction/bin:/opt/3rd-party/bundles/clearfraction/usr/bin:/opt/3rd-party/bundles/clearfraction/usr/local/bin
LD_LIBRARY_PATH=/usr/lib64:/opt/3rd-party/bundles/clearfraction/usr/lib64:/opt/3rd-party/bundles/clearfraction/usr/local/lib64
XDG_DATA_DIRS=/usr/share:/usr/local/share:/opt/3rd-party/bundles/clearfraction/usr/share:/opt/3rd-party/bundles/clearfraction/usr/local/share:/home/$USER/.local/share/flatpak/exports/share:/var/lib/flatpak/exports/share
XDG_CONFIG_DIRS=/usr/share/xdg:/etc/xdg:/opt/3rd-party/bundles/clearfraction/usr/share/xdg:/opt/3rd-party/bundles/clearfraction/etc/xdg
FONTCONFIG_PATH=/usr/share/defaults/fonts
GST_PLUGIN_PATH_1_0=/usr/lib64/gstreamer-1.0:/opt/3rd-party/bundles/clearfraction/usr/lib64/gstreamer-1.0
EOF

sudo tee -a /etc/profile.d/10-cf.sh << 'EOF'
[[ ! ${PATH} =~ "/opt/3rd-party/bundles/clearfraction/bin" ]] && \
  PATH=$PATH:/opt/3rd-party/bundles/clearfraction/bin:/opt/3rd-party/bundles/clearfraction/usr/bin:/opt/3rd-party/bundles/clearfraction/usr/local/bin

[[ ! ${LD_LIBRARY_PATH} =~ "/opt/3rd-party/bundles/clearfraction/usr/lib64" ]] && \
  LD_LIBRARY_PATH=/usr/lib64:/opt/3rd-party/bundles/clearfraction/usr/lib64:/opt/3rd-party/bundles/clearfraction/usr/local/lib64${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}

[[ ! ${XDG_DATA_DIRS} =~ "/opt/3rd-party/bundles/clearfraction/usr/share" ]] && \
  XDG_DATA_DIRS=${XDG_DATA_DIRS:-/usr/local/share/:/usr/share/}:/opt/3rd-party/bundles/clearfraction/usr/share/:/opt/3rd-party/bundles/clearfraction/usr/local/share/

[[ ! ${XDG_CONFIG_DIRS} =~ "/opt/3rd-party/bundles/clearfraction/usr/share/xdg" ]] && \
  XDG_CONFIG_DIRS=${XDG_CONFIG_DIRS:-/usr/share/xdg:/etc/xdg}:/opt/3rd-party/bundles/clearfraction/usr/share/xdg:/opt/3rd-party/bundles/clearfraction/etc/xdg

[[ ! ${FONTCONFIG_PATH} =~ "/usr/share/defaults/fonts" ]] && \
  FONTCONFIG_PATH=/usr/share/defaults/fonts${FONTCONFIG_PATH:+:$FONTCONFIG_PATH}

[[ ! ${GST_PLUGIN_PATH_1_0} =~ "/opt/3rd-party/bundles/clearfraction/usr/lib64/gstreamer-1.0" ]] && \
  GST_PLUGIN_PATH_1_0=${GST_PLUGIN_PATH_1_0:-/usr/lib64/gstreamer-1.0}:/opt/3rd-party/bundles/clearfraction/usr/lib64/gstreamer-1.0
EOF

Environment tuning needed for better system integration. Related: swupd-client#1420, swupd-client#1464, swupd-client#1463, swupd-client#1428, swupd-client#1421.

More guides:

• Waydroid
• termfilechooser

Optional steps:

• glib-compile-schemas /opt/3rd-party/bundles/clearfraction/usr/share/glib-2.0/schemas fix the gsettings schema error

• rm -rf ~/.cache/gstreamer-1.0 fix for gstreamer AAC audio playback

Install software

The repository provides separate codecs and codecs-cuda bundles. Preferably, choose one and not install both. If needed, remove the existing codecs installation first.

• sudo swupd 3rd-party bundle-list -a - show available bundles

• sudo swupd 3rd-party bundle-add codecs - install ffmpeg & gstreamer-libav with dependencies, supporting Intel (qsv, vaapi) and AMD (vaapi)

• sudo swupd 3rd-party bundle-add codecs-cuda - install ffmpeg & gstreamer-libav with dependencies, supporting AMD (vaapi, vdpau), Intel (qsv, vaapi), and NVIDIA (nvdec, vaapi, vdpau), also includes the (nvdec, vdpau) backend vaapi drivers

How to get updates

sudo swupd 3rd-party update

How to repair

• sudo swupd 3rd-party repair
• sudo swupd 3rd-party remove clearfraction && sudo swupd 3rd-party add clearfraction https://clearfraction.vercel.app/update

Video playback in Firefox

echo "export LD_LIBRARY_PATH=/opt/3rd-party/bundles/clearfraction/usr/lib64" >> "${HOME}/.config/firefox.conf"

Apply the following Firefox settings via about:config:

• media.ffmpeg.vaapi.enabled to true
• media.ffvpx.enabled and media.av1.enabled to false - useful for Youtube if your hardware doesn't supports VP9 or AV1 acceleration

For NVidia graphics recommend to try the config written by @marioroy:

curl -L https://github.com/marioroy/nvidia-driver-on-clear-linux/raw/main/HWAccel/firefox/firefox.conf -o "${HOME}/.config/firefox.conf"

For NVidia hardware acceleration set the widget.dmabuf.force-enabled to true in about:config.

Documentation

• Docs
  • How it works
  • How to build software using Clear Fraction libraries like x264, x265 or CUDA

Donate

• Patreon

• 

• PayPal

Patrons:

• Air Dedman - CF Worshipper

Special thanks to:

• @kuboosoft & @lebensterben for tech consulting