SO业务编排>> soulseek-cli>> 返回
项目作者： aeyoll

项目描述 ：
A Soulseek Cli client.
高级语言： JavaScript
项目地址: git://github.com/aeyoll/soulseek-cli.git
创建时间： 2017-10-01T19:24:06Z
项目社区：https://github.com/aeyoll/soulseek-cli
开源协议：MIT License
下载


Soulseek CLI

Build Status

A Soulseek Cli client.

Requirements

NodeJS >= 20

Installation

  1. npm install -g soulseek-cli

On Linux

One of soulseek-cli dependencies (node-keytar) uses libsecret, so you need to install it before running npm install.

Depending on your distribution, you will need to run the following command:

  • Debian/Ubuntu: sudo apt-get install libsecret-1-dev
  • Red Hat-based: sudo yum install libsecret-devel
  • Arch Linux: sudo pacman -S libsecret

On Headless Linux

On Linux, node-keytar uses the Linux SecretService API. It is possible to use the SecretService backend on Linux systems without X11 server available (only D-Bus is required). In this case, you can do the following (exemple is on a Debian environment):

Install dependencies

  1. apt install gnome-keyring --no-install-recommends # Install the GNOME Keyring daemon. "no-install-recommends" prevents X11 install

Usage

  1. dbus-run-session -- $SHELL # Start a D-Bus session
  2. echo 'root' | /usr/bin/gnome-keyring-daemon -r -d --unlock # Unlock GNOME Keyring
  3. soulseek ... # Use soulseek-cli normally

Commands

Login

Before being able to search, you need to be logged in.

Usage:

  1. soulseek login

You will be prompted your Soulseek login and password. Credentials are stored and encrypted in your system keychain.

Alternatively, you can also login by setting environment variables:

  1. export SOULSEEK_ACCOUNT=youraccount
  2. export SOULSEEK_PASSWORD=yourpassword
  3. soulseek download "..."

Download

Download with required query.

Usage:

  1. soulseek download|d [options] [query...]

:warning: This command used to be called search in versions prior to 0.1.0.

Options:

Option Description
-d —destination downloads’s destination
-q —quality show only mp3 with a defined quality
-m —mode filter the kind of files you want (available: “mp3”, “flac”, default: “mp3”)
-h —help display help for command

Examples:

  1. soulseek download "Your query" # Download in the current folder
  2. soulseek download "Your query" --destination=/path/to/directory # Download in a defined folder (relative or absolute)
  3. soulseek download "Your query" --quality=320 # Filter by quality
  4. soulseek download "Your query" --mode=flac # Filter by file type

Query

Search with required query, but don’t download anything. If a result is found, the return code will be 0. Otherwise,
the return code will be 1 (useful for scripting)

Usage:

  1. soulseek query|q [options] [query...]

Options:

Option Description
-q —quality show only mp3 with a defined quality
-m —mode filter the kind of files you want (available: “mp3”, “flac”, default: “mp3”)
-h —help display help for command

Contribution

See CONTRIBUTING.md.