Metadata-Version: 2.2
Name: discodos
Version: 3.2.0
Summary: DJ and record collector's toolbox for Discogs
Home-page: https://discodos.jojotodos.net
Author: J0J0 Todos
License: GPLv3+
Project-URL: Bug Tracker, https://github.com/joj0/discodos/issues
Project-URL: Documentation, https://discodos.readthedocs.io
Project-URL: Source Code, https://github.com/joj0/discodos/
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Environment :: Console
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: Click
Requires-Dist: tabulate
Requires-Dist: PyYaml
Requires-Dist: click-option-group
Requires-Dist: dropbox
Requires-Dist: musicbrainzngs
Requires-Dist: rich
Requires-Dist: textual
Requires-Dist: python3-discogs-client>=2.8
Requires-Dist: webdavclient3
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: summary

# 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)
