beetbox / beetbox/beets

docs: Identify and clean up references to broken or unmaintained plugins

Open
#5,780 7 comments 6 reactions 0 assignees View on GitHub
discussion docs
Dominant language
Python
Stars
15.7k
Forks
2.1k
Avg merge
4d 21h
Merged PRs (30d)
31

Description

There are currently several plugins referenced in the documentation and ecosystem that appear to be outdated, unmaintained, or no longer functional. This makes it harder for users to find reliable tools and contributes to confusion about what's actively supported.

## Objective

We should audit the list of known plugins (in the docs) and identify:

- Plugins that are broken or no longer work with current Beets versions
- Plugins that are no longer maintained (e.g., stale repos, no recent commits/issues)
- Any links in the docs or plugin lists that are dead or outdated
- The sidebar of the plugins in the docs is way to long! We should put them into the same categories as in the main page.

This issue was prompted by #5779 noting that some plugins, while historically useful (like `beets-copyartifacts`), may no longer be actively supported or even working with the current beets version.

Contributor guide

Open the contributing guide

Research direction

Start by auditing the known-plugin list and the plugins documentation sidebar, checking each referenced plugin’s links, maintenance status, and compatibility with current Beets versions. Use #5779 and beets-copyartifacts as initial context. Done means broken or unmaintained references are identified and cleaned up, and the sidebar uses the same categories as the main page.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.