Skip site
navigation (1)Skip section navigation (2)
FreeBSD Manual Pages
- beetsconfig(5)
- beets configuration file Beets has an extensive configuration system that lets you customize nearly every aspect of its operation. To configure beets, you create a file called config.yaml. The location of the file depends on your platform (type beet config -p to see the path on your system): 0.0 (bu 2 On Unix-like OSes, write ~/.config/beets/config.yaml. (bu 2 On Windows, use %APPDATA%ebeetseconfig.yaml. This is usually in a directory like C:eUserseYoueAppDataeRoaming. (bu 2 On OS X, you can use either the Unix location or ~/Library/Application Support/beets/config.yaml. You can launch your text editor to create or update your configuration by typing beet config -e. (See the X'tty: link #config-cmd'%configX'tty: link' command for details.) It is also possible to customize the location of the configuration file and even use multiple layers of configuration. See %Configuration Location, below. The config file uses X'tty: link https://yaml.org/'%YAMLX'tty: link' syntax. You can use the full power of YAML, but most configuration options are simple key/value pairs. This means your config file will look like this: 0.0 3.5 option: value another_option: foo bigger_option: key: value foo: bar In YAML, you will need to use spaces (not tabs!) to indent some lines. If you have questions about more sophisticated syntax, take a look at the X'tty: link https://yaml.org/'%YAMLX'tty: link' documentation. The rest of this page enumerates the dizzying litany of configuration options available in beets. You might also want to see an %example. 0.0 (bu 2 %Global Options 2.0 (bu 2 %library (bu 2 %directory (bu 2 %plugins (bu 2 %include (bu 2 %pluginpath (bu 2 %ignore (bu 2 %ignore_hidden (bu 2 %replace (bu 2 %path_sep_replace (bu 2 %asciify_paths (bu 2 %art_filename (bu 2 %threaded (bu 2 %format_item (bu 2 %format_album (bu 2 %sort_item (bu 2 %sort_album (bu 2 %sort_case_insensitive (bu 2 %original_date (bu 2 %artist_credit (bu 2 %per_disc_numbering (bu 2 %aunique (bu 2 %sunique (bu 2 %terminal_encoding (bu 2 %clutter (bu 2 %max_filename_length (bu 2 %id3v23 (bu 2 %va_name (bu 2 %UI Options 2.0 (bu 2 %color (bu 2 %colors (bu 2 %terminal_width (bu 2 %length_diff_thresh (bu 2 %import (bu 2 %Importer Options 2.0 (bu 2 %write (bu 2 %copy (bu 2 %move (bu 2 %link (bu 2 %hardlink (bu 2 %reflink (bu 2 %resume (bu 2 %incremental (bu 2 %incremental_skip_later (bu 2 %from_scratch (bu 2 %quiet (bu 2 %quiet_fallback (bu 2 %none_rec_action (bu 2 %timid (bu 2 %log (bu 2 %default_action (bu 2 %languages (bu 2 %ignored_alias_types (bu 2 %detail (bu 2 %group_albums (bu 2 %autotag (bu 2 %duplicate_keys (bu 2 %duplicate_action (bu 2 %duplicate_verbose_prompt (bu 2 %bell (bu 2 %set_fields (bu 2 %singleton_album_disambig (bu 2 %MusicBrainz Options 2.0 (bu 2 %enabled (bu 2 %searchlimit (bu 2 %extra_tags (bu 2 %genres (bu 2 %external_ids (bu 2 %Autotagger Matching Options 2.0 (bu 2 %max_rec (bu 2 %preferred (bu 2 %ignored (bu 2 %required (bu 2 %ignored_media (bu 2 %ignore_data_tracks (bu 2 %ignore_video_tracks (bu 2 %Path Format Configuration (bu 2 %Configuration Location 2.0 (bu 2 %Environment Variable (bu 2 %Command-Line Option (bu 2 %Default Location (bu 2 %Example
- edgepaint(1)
- edge coloring to disambiguate crossing edges
