whatcd-cli

#+STYLE: #text-5-1 b { color: red }

• whatcd-cli [[https://travis-ci.org/CodyReichert/whatcd-cli.svg?branch=master]] [[http://img.shields.io/badge/license-GNU%20GPLv3-red.svg]] **** whatcd-cli is a command line interface for browsing, searching, and downloading from what.cd.

• Install *** NPM install The quickest way to install is to get the latest version from npm:

  #+BEGIN_SRC bash $ npm install -g whatcd-cli #+END_SRC

*** Latest from Github or get the latest changes from github

#+BEGIN_SRC bash $ npm install -g CodyReichert/whatcd-cli #+END_SRC

Read the alternative installation section below for more help with installing.

• Running You can start whatcd-cli by running:

  #+BEGIN_SRC bash $ whatcd #+END_SRC

You can enter your username and password when prompted, or you can create a configuration file. Read more below.

• Configuration You can store your what.cd credentials in a .whatcd config file. Store the file in either ~/.whatcd or /home/<username>/.whatcd. Use the following format:

*** Config file #+BEGIN_SRC javascript module.exports = { username: "Your what.cd username", password: "Your what.cd password", torrentDirectory: "/path/to/save/torrents/" } #+END_SRC

The torrentDirectory is where whatcd-cli will save all torrent files. My recommendation is to have your torrent client automatically start files added to this directory.

*** Running without a config file whatcd-cli does not require you to keep a plain text configuration. If you start whatcd-cli without a config file, it will simply prompt you for your username and password. If you download a file in this mode, it will always download to the current working directory.

• Usage This command line interface allows you to browse what.cd torrents, arists, and albums (and a couple other things) directly from the command line. Currently, most of the searches you can make on what.cd are supported.

  To search, you can enter a query from the main menu (which will match all albums, artists, singles, etc), or you can choose one of the advanced search options:

  • Download file - /D or d/
    • Enter this from the main menu to download a torrent file. You will be prompted for the ID of the torrent. It will save to your torrentsDirectory set in your settings.js file.
  • Top 10 torrents of the day - /Top or top/
    • Enter this from the main menu to view the top 10 most active torrents of the day.
  • Similar Artists - /S or s/
    • Enter this from the main menu to find similar artists. You will be prompted for an artist name. It will show the top 10 (or less) matches.
  • Artist search - /A or a/
    • Not yet implemented.
  • Torrent search - /T or t/
    • Not yet implemented.

• Roadmap and Future Development Below is a list of features and changes that I would personally like to see happen. Feel free to create an issue with a feature request to get it added to the roadmap. Or even better, create a pull request implementing the feature you want.

*** Command line API (non-interactive mode) One of the first things I want to do is have single command interactions, so the interactive mode is optional. So you could just do something like this to download a file:

#+BEGIN_SRC bash $ whatcd -d "torrent-id" #+END_SRC

or this to get album an album in a certain format

#+BEGIN_SRC bash $ whatcd -a "Brand New" -b "Daisy" -f "FLAC" #+END_SRC

• Alternative installations *** Installing without NPM If you don't have or want to use npm, you can clone the repo and run directly with node:

  #+BEGIN_SRC bash git clone [e-mail]:CodyReichert/whatcd-cli cd whatcd-cli/ npm install node src/whatcd.js #+END_SRC

  Follow the config files steps above

*** Latest stable release from github The npm install command above will install the latest changes. If you have problems install the lastest stable release instead.

#+BEGIN_SRC bash npm install -g CodyReichert/whatcd-cli/0.2.0 #+END_SRC

• Licensing and Disclaimer *** GNU General Public License v3.0

  This software is licensed under the GNU General Publice License Version 3.0

  WhatCD-cli is a command-line interface for browsing and downloading what.cd torrents.

  Copyright (C) 2014 Cody Reichert

  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

  You should have received a copy of the GNU General Public License along with this program. If not, see [[http://www.gnu.org/licenses/]]

  For any additional information or questions, you can contact me at: [[mailto:[e-mail]][[e-mail]]]