/ffmpeg-audio-thumbnailer

Minimal thumbnailer for audio files using ffmpeg that can be used by file managers to create thumbnails for audio files

Primary LanguageMakefileGNU General Public License v3.0GPL-3.0

FFMPEG audio thumbnailer

FFMPEG audio thumbnailer (ffmpeg-audio-thumbnailer) is a simple audio file thumbnailer for file managers, such as nautilus, dolphin, thunar, and nemo.

Installing on various Linux distributions

Arch Linux, Manjaro Linux and derivatives

ffmpeg-audio-thumbnailer is available in the AUR. The VCS version is also available.

Install using your favorite AUR helper, e.g.,

$ yay -S ffmpeg-audio-thumbnailer

You may also install manually using makepkg to build from the AUR directly (not recommended).

# pacman -S --needed git base-devel
$ git clone https://aur.archlinux.org/ffmpeg-audio-thumbnailer.git --depth 1
$ cd ffmpeg-audio-thumbnailer
$ makepkg -s --asdeps
# pacman -U ffmpeg-audio-thumbnailer-*-any.pkg.tar.zst

Manjaro users: You can install using pamac (aka Add/Remove Software).

$ pamac build ffmpeg-audio-thumbnailer

Other Linux distributions

This package should theoretically work on any Linux distribution with ffmpeg installed. If you'd like support added for your distribution, please open a new issue, after ensuring that nobody else has already requested that distro. If you are a maintainer for a distribution, please don't hesitate to add this package! Alternatively, build and install from the source directly (see below).

Usage

After installation, file managers should automatically use the thumbnailer to give new files a thumbnail. To also give existing files a thumbnail, clear the thumbnail cache

$ rm -rf ~/.thumbnails
$ rm -rf ~/.cache/thumbnails

Building from source

Dependencies:

  • make (at buildtime)
  • ffmpeg (at runtime)

To install the thumbnailer, run

# make PREFIX=/usr install

Remember that files installed with make install cannot be removed by a package manager. As far as I know, installing thumbnailers in the user's home directory is not supported.

To uninstall, run

# make PREFIX=/usr uninstall

License and Legal

See COPYING.md for details.

GNU General Public License