https://github.com/joj0/discodos

DJ and record collector's toolbox for Discogs
https://github.com/joj0/discodos

acousticbrainz discogs discogs-api discogs-client discogs-search dj-tools music-management music-manager musicbrainz playlist playlist-manager record vinyl

Last synced: 3 months ago
JSON representation

DJ and record collector's toolbox for Discogs

• Host: GitHub
• URL: https://github.com/joj0/discodos
• Owner: JOJ0
• License: gpl-3.0
• Created: 2018-09-22T16:06:31.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2025-06-20T12:38:11.000Z (4 months ago)
• Last Synced: 2025-06-20T13:45:02.645Z (4 months ago)
• Topics: acousticbrainz, discogs, discogs-api, discogs-client, discogs-search, dj-tools, music-management, music-manager, musicbrainz, playlist, playlist-manager, record, vinyl
• Language: Python
• Homepage: http://discodos.readthedocs.io
• Size: 163 MB
• Stars: 65
• Watchers: 5
• Forks: 8
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# README

```python

        _______  _______ ________

 D i s c o     \        /       /

      /  ___   /  ___  /  _____/

     /  /  /  /  /  /  \____  \

    /  /__/  /  /__/  _____/  /

   /                /      record collector's toolbox

  /_______/\_______/________/

```

DiscoDOS is a set of command line tools for DJ's and record collectors.

- It's based on data fetched from a user's [Discogs](https://www.discogs.com) record [collection](https://support.discogs.com/hc/en-us/articles/360007331534-How-Does-The-Collection-Feature-Work-) and [Marketplace inventory](https://support.discogs.com/hc/en-us/categories/360000845253-Selling-on-Discogs).

- [List records for sale](https://discodos.readthedocs.io/en/latest/MANUAL.html#the-sell-command) on the Discogs Marketplace.

- [Edit Marketplace listings](https://discodos.readthedocs.io/en/latest/MANUAL.html#the-ls-tui-command) in a self-explanatory [_TUI_ interface](https://discodos.readthedocs.io/en/latest/MANUAL.html#the-ls-tui-command).

- Metadata of DJ sets can be tracked and analyzed to feed a simple ["suggestion" mechanism](https://discodos.readthedocs.io/en/latest/MANUAL.html#the-suggest-command).

- [Organize tracks into playlists](https://discodos.readthedocs.io/en/latest/MANUAL.html#the-mix-command) and rate mix-transitions.

- Link the collection to [MusicBrainz](https://musicbrainz.org) and [AcousticBrainz](https://acousticbrainz.org), to provide key and BPM data of tracks. These features are deprecated but still work partly - [read more about it here](https://discodos.readthedocs.io/en/latest/MANUAL.html#acousticbrainz-support-is-deprecated).

DiscoDOS is a command line tool, though [parts of it provide a TUI - a _text user interface_](https://discodos.readthedocs.io/en/latest/MANUAL.html#the-ls-tui-command). DiscoDOS is written in Python and runs on Linux, macOS and Windows.

### Viewing and editing sales & collection items in `dsc ls`

![dsc ls full screen](sphinx/source/_static/ls-default-full-screen.png)

### Importing

![dsc import basic](sphinx/source/_static/import-basic.gif)

### Selling records

![dsc sell](sphinx/source/_static/sell-super-system.gif)

### More Screenshots & Videos

- [Media gallery on discodos.readthedocs.io](https://discodos.readthedocs.io/en/latest/VIDEO_TUTORIALS.html)

- [Blog post featuring many animated GIFs](https://blog.jojotodos.net/discodos3)

### Docs

- [Quickstart Guide](https://discodos.readthedocs.io/en/latest/QUICKSTART.html)

- [Setup Guide](https://discodos.readthedocs.io/en/latest/INSTALLATION.html)

- [User's Manual](https://discodos.readthedocs.io/en/latest/MANUAL.html)

### Website

- [discodos.jojotodos.net](https://discodos.jojotodos.net)