PJ-Player

PJ-Player is a Rust-based terminal application (TUI) that allows users to search, DOWNLOAD or STREAM audio tracks directly from the terminal. It supports downloading and streaming from YouTube and Internet Archive.

DEMO

Features

• Search for audio on YouTube or Internet Archive.
• Stream audio on YouTube.
• Download audio from YouTube or Internet Archive.

Requirements

Before running PJ-Player, you need to ensure that the following dependencies are installed on your system:

• Rust: This project is written in Rust. Install Rust by following the instructions at https://www.rust-lang.org/tools/install.
• yt-dlp: A YouTube downloader tool. Install it from https://github.com/yt-dlp/yt-dlp.
• ffmpeg: A complete, cross-platform solution to record, convert and stream audio and video. Install it from https://ffmpeg.org/.

Installation

To use [PJ-Player]

1. Clone the Repository: Clone this repository to your local machine:

   git clone https://github.com/rezkhaleghi/pj-player.git
   cd pj-player

2. Install Dependencies (if not already installed):

   • Install Dependencies Manually
   • OR Run the install.sh (for macos: install-macos.sh) script in bin Directory (Assuming your in the /pj-player Directory)

   ./bin/install.sh

3. Build the Project: Build the pjgrep application with the following command:

   cargo build --release

4. Install the Binary: Optionally, you can copy the binary to a directory in your $PATH (e.g., /usr/local/bin or ~/bin) for easy access:

   sudo cp target/release/pjplayer /usr/local/bin/pjplayer

Usage

1. Run the application:

   pjplayer

2. Select DONLOAD / STREAM:

3. Search For Your Favorite Song/Podcast:

   

4. Select One of Search Results:

   

5. Stream Or Download The Content:

• Stream
• Download

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

Author

Created and maintained by "PocketJack (Rez Khaleghi)"

• GitHub: https://github.com/rezkhaleghi
• Email: [email protected]

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

• Rust Programming Language