Home

Awesome

Obsidian Beets Vault

This repository is organized as an Obsidian vault containing media descriptions in markdown format. It can be viewed using any markdown viewer (e.g. almost any browser) but if Obsidian is used then many additional features will be available including queries using the Dataview plugin for Obsidian.

The Obsidian-Beets-Vault repository reflects the partial contents of my personal Beets music library of digital music. As such, it may be relevant only to a few. However, the process by which this repository was created and curated as well as the tools used in its creation and curation may be useful to a wider audience. I am making it public and freely licensed so that others may examine, adapt, clone, and use in whatever manner they choose. See the description of Process for an overview of the process and tools employed in the creation of this repository.

Get started browsing the Obsidian Beets Vault.

Table of Contents

Usage

For the optimal experience, open this vault in Obsidian!

  1. Download the vault
  2. Open the vault in Obsidian via "Open another vault -> Open folder as vault"
  3. Trust us. :)
  4. When Obsidian opens the settings, verify the "Dataview" and other community plugins are enabled
  5. Done! The Obsidian Beets Vault is now available to you in its purest and most useful form!

Dataview

The Obsidian Beets Vault has been curated with metadata allowing queries to be performed using the Obsidian Dataview plugin. Sample queries along with the code used to perform them can be viewed in the Beets Queries document.

Additional visual representations of the Beets Vault, also based upon Dataview queries, are provided by the Excalibrain Obsidian plugin.

The Obsidian Beets Vault markdown contains metadata with tags allowing a variety of Obsidian Dataview queries. For example, the markdown of the book "Timequake" by Kurt Vonnegut Jr. has the following YAML prelude:

---
bookid: 9594
title: Timequake
author: Kurt Vonnegut Jr.
authors: 
isbn: 0099267543
isbn13: 9780099267546
rating: 4
avgrating: 3.72
publisher: Vintage Classics
binding: Paperback
pages: 219
published: 1997
shelves: science-fiction, novels, vonnegut
shelf: read
review: 
---

The above book metadata can be used to perform Dataview queries to search, filter, and retrieve books as if they are in a database. For example, to produce a table of all books in this vault by Kurt Vonnegut Jr. published prior to 1970 add the following to a markdown file in the vault:

```dataview
TABLE
  title AS "Title",
  author AS "Author",
  published AS "Year"
FROM "Books"
WHERE author = "Kurt Vonnegut Jr." and published < 1970
SORT published ASC
```

Screenshot

Dataview Queries

Sample queries along with the code used to perform them can be viewed in the Beets Queries document. Additional example Beets Dataview queries can be viewed at:

Beets_library

The Obsidian Beets Vault includes entries derived from my Beets music library. See the Process section below for details on this vault setup procedure.

Beets

To index and categorize a Beets music library, the MusicPlayerPlus package can be used. MusicPlayerPlus provides command line utilities that can be used to query, list, and manage various aspects of a Beets library. The scripts used to produce the Beets markdown for this repository can be found in Tools/Beets/. See Beets Albums by Artist to view an index of Beets albums by artist.

Structure

The Beets vault is organized by artist subfolders containing markdown for each album by that artist in the Beets library. For example, all albums by progressive rock band 'Yes' are in the Beets/Yes/ folder.

Process

See the Process document for a detailed description of the tools and process used to generate this vault.

Obsidian_Plugins

Obsidian community plugins we have found useful and can recommend include the following:

See_also