Awesome

Obsidian Media 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-Media-Vault repository reflects the partial contents of my personal library of books, cds, digital music, and records. 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.

[Note:] This is a fairly large repository, over 4GB, half of which is album and book cover art. The Obsidian mobile applications may not be able to handle this size vault. The desktop Obsidian application for Windows, Mac, or Linux are recommended for use with this vault. Each of the components of this "super vault" have been split out into their own smaller vaults. To download and view these "sub-vaults", see:

Get started browsing the Obsidian Media Vault.

Usage
Dataview
- Screenshot
Libraries
- Apple
- Beets
- Books
- CD
- Discogs
- Roon
  - Playlists
- Vinyl
Structure
Process
Obsidian Plugins
See also

Usage

For the optimal experience, open this vault in Obsidian!

Download the vault
Open the vault in Obsidian via "Open another vault -> Open folder as vault"
Trust us. :)
When Obsidian opens the settings, hit the switch on "Dataview" to enable the plugin
Done! The Obsidian Media Vault is now available to you in its purest and most useful form!

Dataview

The Obsidian Media 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 Media Queries document.

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

The Obsidian Media 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
  link(file.link, 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 Media Queries document.

Libraries

The Obsidian Media Vault includes entries from several media libraries including my Books, CDs, Vinyl records, Apple Music, Roon Audio System, and Beets music libraries. See the Process section below for details on this vault setup procedure.

Apple

An XML format export of an Apple Music library can be generated in Apple Music by selecting File -> Library -> Export Library. Included in this repository are several scripts used to convert and process the Apple Music XML export into Markdown. These can be found in the Tools/Apple/ folder.

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.

Books

The 'Books' subfolder of this Obsidian vault was created by exporting my Goodreads library of books to CSV. I then used csvkit and command line tools to convert the CSV format Goodreads data to Markdown. Each Markdown document created in this way contains extensive metadata that can be used to query the vault with Dataview. See Books_by_Author to view an index of books by author.

CD

My CDs are catalogued in Collectorz. See Process.md for details on how to export a Collectorz library. See CD_by_Artist to view an index of CDs by artist.

Discogs

Discogs users with curated Discogs collections can generate markdown format files for all items and artists in their Discogs collection using the Discogs API. See Process.md for details on how to automate this process.

Beets and Discogs provide the greatest amount of detail and information on albums, artists, and releases in your library.

To view example markdown generated by this process, see:

Roon

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

Playlists

Playlists from the Roon Audio System were generated using the RoonCommandLine command roon -l playtracks.

Vinyl

My vinyl records are catalogued in Discogs. See Process.md for details on how to export a Discogs library.