valrus/beetsplug-covergrid
1
0
Fork 0
Code Issues 2 Pull requests Projects Releases Packages Wiki Activity Actions
A plugin to show cover art for albums in a Beets library in a grid in a Web browser.
11 commits 1 branch 0 tags 838 KiB
  • JavaScript 84.2%
  • Python 8.7%
  • HTML 2.8%
  • CSS 2.5%
  • Nix 1.8%
Find a file
Exact
valrus d059cf4314 bump version for screenshot publish
2025-12-14 16:59:07 -08:00
src/beetsplug/covergrid bump version for screenshot publish 2025-12-14 16:59:07 -08:00
tests Copy from beets web plugin and package 2025-12-07 10:27:59 -08:00
.gitignore Copy from beets web plugin and package 2025-12-07 10:27:59 -08:00
flake.nix Copy from beets web plugin and package 2025-12-07 10:27:59 -08:00
LICENSE.txt Copy from beets web plugin and package 2025-12-07 10:27:59 -08:00
pyproject.toml Require beets 2.4.0 2025-12-14 09:53:11 -08:00
README.md actual url for screenshot in readme 2025-12-14 16:58:17 -08:00
screenshot.jpeg Update README 2025-12-14 08:55:54 -08:00

README.md

beetsplug-covergrid

PyPI - Version PyPI - Python Version

What Is This

A very (very) basic cover art browser for the beets music tagger. It shows your album art in an attractive grid in a web browser:

A screenshot of the cover grid interface. It shows about 25 album covers arranged in a grid that's 5 wide. Some of the album covers are just plain text, indicating the art is not available. There is a scroll bar on the right side.

Table of Contents

Installation

If you installed beets with pipx like the instructions recommend:

pipx inject beets beetsplug-covergrid

If you installed beets with pip, I think you can just do:

pip install beetsplug-covergrid

If not: I'm not sure! There are about as many ways to install things in Python as there are people using Python.

Usage

Add covergrid to the plugins section of your beets config. If needed, configure it with the options described in the docs for the beets web plugin.

Then start the server with

beet covergrid

and navigate to the URL it gives you in a web browser.

When you're done, terminate the server with ctrl-c.

Currently this is in "MVP" (minimum viable product) state, as follows:

  • There is no interactivity besides scrolling.
  • Albums are shown in random order and this cannot be changed.

This is a personal project and I've done the minimum to meet my needs at this time, but I may expand the feature set as I get the urge. See the Issues tab for things I'm thinking about doing, if any.

Other Things

If you enjoy beetsplug-covergrid and are on a Mac, you may find my other weird music tool alfred-mpd interesting.

I also make music, under the name "walrus promenade." Find it on bandcamp.

License

beetsplug-covergrid is distributed under the terms of the MIT license.

This plugin is based on the web plugin included with beets.