Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

View and search for artists, labels and releases in the library, from the command line.

Project Description



discogs-cli bring the database to your terminal. Perform the following actions from your terminal

  • Search artists, releases, labels
  • View artist information and their releases
  • View label details and its associated releases
  • View a release in detail

Access to search functionality

Discogs requires authentication when accessing the search APIs. If you wish to use the search functionality, you’re required to generate a personal access token for your account. You can do so at by clicking generate new token.

Before starting your application set the TOKEN shell variable. where sys64738 is your unique access token.

$ export TOKEN=sys64738


To install from PyPi, please use pip or easy_install. For example

$ pip install discogs-cli


$ easy_install discogs-cli

Note that installing into a virtualenv is generally recommended. If you wish to install the latest and greatest via github source, please ensure you’ve created a virtual environment.

$ virtualenv ~/.virtualenv/discogs-cli
$ source ~/.virtualenv/discogs-cli/bin/activate

Fetch and install the package from github

$ pip install git+

Once installed, run discogs-cli to launch the interactive command prompt.

$ discogs-cli

To launch commands from the console

$ ogs <command> [params] [options]


  • Currently runs on a Unix like operating system only (Linux/OSX). If you can test and patch use for windows, please log a pull request.


discogs-cli builds upon the following awesome Python libraries * The python-prompt-toolkit * api client * Haxor-news string completion library

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(9.9 kB) Copy SHA256 Hash SHA256
Source Feb 19, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting