From ce3d2c5802974474be161c5aee2814b798f99f68 Mon Sep 17 00:00:00 2001
From: anonymous <>
Date: Tue, 25 Apr 2023 21:53:57 -0400
Subject: [PATCH] create/update 'beets config.md' file

---
 beets config.md | 160 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 160 insertions(+)
 create mode 100644 beets config.md

diff --git a/beets config.md b/beets config.md
new file mode 100644
index 0000000..65f2a2e
--- /dev/null
+++ b/beets config.md	
@@ -0,0 +1,160 @@
+# beets config
+
+> The purpose of beets is to get your music collection right once and for all. It catalogs your collection, automatically improving its metadata as it goes using the [MusicBrainz](http://musicbrainz.org/) database. Then it provides a bouquet of tools for manipulating and accessing your music.
+
+Stored at `$HOME/.config/beets/config.yaml`
+
+```yaml
+directory: /mnt/chawley/Music
+library: /home/chawley/musiclibrary.blb
+
+import:
+    # write metadata to music files
+    write: yes
+
+    # move imported files from source to the music directory
+    move: yes
+    copy: no
+    delete: no
+
+    # use auto-tagging where possible
+    # do not require confirmation on strong matches
+    autotag: yes
+    timid: no
+
+    resume: ask
+    incremental: no
+    none_rec_action: ask
+    log:
+
+    quiet: no  # enable with command line option
+    quiet_fallback: skip
+    default_action: apply
+
+    singletons: no
+    languages: #howto
+    detail: no
+    flat: no
+
+# use the release-date of the original (first) release of an album?
+original_date: yes
+
+# on multi-disk releases, assign track numbers for the whole album.
+# If "per disk", make sure tracknames do not collide ("paths" setting).
+per_disc_numbering: no
+
+# files matching these patterns are deleted from source after import
+clutter: ["Thumbs.DB", ".DS_Store", "*.m3u", ".pls", "*.jpg"]
+
+# files/directories matching one of these patterns are ignored during import
+ignore: [".*", "*~", "System Volume Information"]
+
+# Paths ----------------------------------------------------------------------
+
+# Paths and filenames for music files
+# relative to music directory
+paths:
+    default: $albumartist - $year - $album/$albumartist - $track - $title
+    singleton: Non-Album/$artist - $title
+    comp: $album ($year)/$track - $artist - $title
+
+# replace special characters in generated filenames
+replace:
+    '[\\/]': _
+    '^\.': _
+    '[\x00-\x1f]': _
+    '[<>:"\?\*\|]': _
+    '\.$': _
+    '\s+$': ''
+
+path_sep_replace: _
+
+# filename for the album art
+art_filename: cover  # results in "cover.jpg"
+
+max_filename_length: 0  # unlimited
+
+
+# General --------------------------------------------------------------------
+
+# use mutliple threads during import
+threaded: yes
+timeout: 5.0
+verbose: no
+
+
+# User Interface -------------------------------------------------------------
+
+color: yes
+list_format_item: %upper{$artist} - $album - $track. $title
+list_format_album: %upper{$albumartist} - $album
+time_format: '%Y-%m-%d %H:%M:%S'
+terminal_encoding: utf8
+
+ui:
+    terminal_width: 80
+    length_diff_thresh: 10.0
+
+
+# Auto Tagger ----------------------------------------------------------------
+
+match:
+    strong_rec_thresh: 0.1      # match 90% or better for auto import
+    medium_rec_thresh: 0.25
+    rec_gap_thresh: 0.25
+    max_rec:
+        missing_tracks: medium
+        unmatched_tracks: medium
+    distance_weights:
+        source: 2.0
+        artist: 3.0
+        album: 3.0
+        media: 1.0
+        mediums: 1.0
+        year: 1.0
+        country: 0.5
+        label: 0.5
+        catalognum: 0.5
+        albumdisambig: 0.5
+        album_id: 5.0
+        tracks: 2.0
+        missing_tracks: 0.9
+        unmatched_tracks: 0.6
+        track_title: 3.0
+        track_artist: 2.0
+        track_index: 1.0
+        track_length: 2.0
+        track_id: 5.0
+    preferred:
+        countries: []
+        media: []
+        original_year: no
+    ignored: []
+    track_length_grace: 10
+    track_length_max: 30
+```
+
+## Reference
+
+*   [Beets is the media library management system for obsessive-compulsive music geeks.](https://beets.io)
+*   [My Beets Config - Github Gist](https://gist.github.com/crh0831/c550392ef75a5637c82d2e708fc74b8c)
+
+## Beets Notes
+
+**2017-01-03** - I got sidetracked and started re-tagging all my music in Plex using beets after reading glowing reviews in a couple posts on reddit.
+
+Its pretty nice. I decided to move everything that was beets imported to a new directory and point Plex at that directory as my new library.
+
+I guess beets does A LOT of stuff, most of which I haven't even begun to understand. Accordingly I've had 3 beets tabs open in Chrome for the last few days. I thought this might be a good place to collect what I know so far so I can close those tabs.
+
+This way I can come back to this if I want to pursue it further.
+
+*   [Getting Started](http://beets.readthedocs.io/en/v1.4.2/guides/main.html)
+*   [Path Formats - Template Functions](http://beets.readthedocs.io/en/v1.4.2/reference/pathformat.html)
+*   [Somebody's beets config sample](http://akeil.net/listings/beets.config.yaml.html)
+
+**2017-05-25** - Beets has served me well. So well, that I am taking the tagged music repository out of Plex and moving it to shawshank and will use Cherry Music as a front-end.
+
+*   Beets config is located at `$HOME/.config/beets/config.yaml`
+*   Import directory of music with: `beet import <directory-name>`
+*   Delete album with: `beet rm -a "Jon Oliva" -d` (`-a` for album and `-d` to delete the files and not just the database entry)
\ No newline at end of file