# code-radio-cli

**Repository Path**: nirvanaReborn_rust/code-radio-cli

## Basic Information

- **Project Name**: code-radio-cli
- **Description**: Code Radio CLI 是基于 Rust 编写的命令行音乐播放器，让你在终端播放音乐
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: https://www.oschina.net/p/code-radio-cli
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-05-23
- **Last Updated**: 2023-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Code Radio CLI

[![Crate](https://img.shields.io/crates/v/code-radio-cli.svg?color=orange)](https://crates.io/crates/code-radio-cli)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/JasonWei512/code-radio-cli)](https://github.com/JasonWei512/code-radio-cli/releases)

🎵 24/7 music designed for coding, now in your terminal!

A command line music radio client for https://coderadio.freecodecamp.org ([about](https://www.freecodecamp.org/news/code-radio-24-7/)), written in Rust.

![Screenshot](./.github/images/screenshot.jpg)

## Install

- Download prebuilt binary from [GitHub release page](https://github.com/JasonWei512/code-radio-cli/releases).
  
- 🪟 On Windows, install with [WinGet](https://github.com/microsoft/winget-cli):
  
  ```
  winget install code-radio-cli
  ```

- 🦀 Install with [Cargo](https://rustup.rs/):
  
  ```
  cargo install code-radio-cli
  ```

  After installation, run `code-radio` in command line to start. You may need to restart your shell first.

### ⚠ About building and running on Linux 🐧

This program uses [rustaudio/cpal](https://github.com/rustaudio/cpal) lib to play audio, which requires ALSA development files on Linux.

In order to build and run this program on Linux, you need to install：

- `libasound2-dev` on Debian / Ubuntu
- `alsa-lib-devel` on Fedora

## Usage

```
code-radio [OPTIONS]

OPTIONS:
    -h, --help                 Print help information
    -n, --no-logo              Do not display logo
    -s, --select-station       Manually select a station
    -v, --volume <VOLUME>      Volume, between 0 and 9 [default: 9]
    -V, --version              Print version information
```