{"id":22550894,"url":"https://github.com/rezkhaleghi/pj-player","last_synced_at":"2025-04-10T03:22:16.893Z","repository":{"id":265436279,"uuid":"895757888","full_name":"rezkhaleghi/pj-player","owner":"rezkhaleghi","description":"pjplayer is a Rust-based CLI tool that allows you to search, download, and stream audio directly from your terminal. It supports platforms like YouTube and Internet Archive. ","archived":false,"fork":false,"pushed_at":"2025-04-07T15:09:50.000Z","size":49262,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T16:27:05.181Z","etag":null,"topics":["ffmpeg","ffplay","free-music-download","media-player","music","music-download","music-player","music-streaming","player","rust","rust-lang","terminal-player","tui","youtube-downloader","youtube-stream","yt-dlp"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rezkhaleghi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-28T20:55:03.000Z","updated_at":"2025-04-07T15:09:53.000Z","dependencies_parsed_at":"2025-04-07T16:35:10.651Z","dependency_job_id":null,"html_url":"https://github.com/rezkhaleghi/pj-player","commit_stats":null,"previous_names":["rezkhaleghi/pj-player"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rezkhaleghi%2Fpj-player","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rezkhaleghi%2Fpj-player/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rezkhaleghi%2Fpj-player/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rezkhaleghi%2Fpj-player/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rezkhaleghi","download_url":"https://codeload.github.com/rezkhaleghi/pj-player/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248148798,"owners_count":21055652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ffmpeg","ffplay","free-music-download","media-player","music","music-download","music-player","music-streaming","player","rust","rust-lang","terminal-player","tui","youtube-downloader","youtube-stream","yt-dlp"],"created_at":"2024-12-07T17:08:51.573Z","updated_at":"2025-04-10T03:22:16.884Z","avatar_url":"https://github.com/rezkhaleghi.png","language":"Rust","funding_links":["https://patreon.com/PocketJack"],"categories":[],"sub_categories":[],"readme":"# PJ-Player\n\nPJ-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.\n\n# DEMO\n\n![Project Demo](/demos/demo.gif)\n\n## Features\n\n- **Search for audio** on YouTube or Internet Archive.\n- **Stream audio** on YouTube.\n- **Download audio** from YouTube or Internet Archive.\n\n## Requirements\n\nBefore running PJ-Player, you need to ensure that the following dependencies are installed on your system:\n\n- **Rust**: This project is written in Rust. Install Rust by following the instructions at [https://www.rust-lang.org/tools/install](https://www.rust-lang.org/tools/install).\n- **yt-dlp**: A YouTube downloader tool. Install it from [https://github.com/yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp).\n- **ffmpeg**: A complete, cross-platform solution to record, convert and stream audio and video. Install it from [https://ffmpeg.org/](https://ffmpeg.org/).\n\n## Installation\n\nTo use [`PJ-Player`]\n\n1. **Clone the Repository**:\n   Clone this repository to your local machine:\n\n   ```sh\n   git clone https://github.com/rezkhaleghi/pj-player.git\n   cd pj-player\n   ```\n\n2. **Install Dependencies** (if not already installed):\n\n   - Install Dependencies Manually \n   - OR Run the install.sh (for macos: install-macos.sh) script in bin Directory\n     (Assuming your in the /pj-player Directory)\n\n   ```sh\n   ./bin/install.sh\n   ```\n\n3. **Build the Project**:\n   Build the pjgrep application with the following command:\n\n   ```sh\n   cargo build --release\n   ```\n\n4. **Install the Binary**:\n   Optionally, you can copy the binary to a directory in your `$PATH` (e.g., `/usr/local/bin` or `~/bin`) for easy access:\n\n   ```sh\n   sudo cp target/release/pjplayer /usr/local/bin/pjplayer\n   ```\n\n## Usage\n\n1. **Run the application**:\n\n   ```sh\n   pjplayer\n   ```\n\n2. **Select DONLOAD / STREAM**:\n   ![Project Demo](/demos/1-select-mode.jpeg)\n\n3. **Search For Your Favorite Song/Podcast**:\n\n   ![Project Demo](/demos/2-search.jpeg)\n\n4. **Select One of Search Results**:\n\n   ![Project Demo](/demos/3-select.jpeg)\n\n5. **Stream Or Download The Content**:\n- Stream\n   ![Project Demo](/demos/4-stream.jpeg)\n- Download\n   ![Project Demo](/demos/5-dl.jpeg)\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request on GitHub.\n\n## Author\n\nCreated and maintained by \"PocketJack (Rez Khaleghi)\"\n\n- GitHub: https://github.com/rezkhaleghi\n- Email: rezaxkhaleghi@gmail.com\n\n## Support\n\nIf you enjoy this app and would like to support my work:\n- Patreon : https://patreon.com/PocketJack\nYour support helps me continue developing free and open-source stuff.\n\n\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n## Acknowledgements\n\n- [Rust Programming Language](https://www.rust-lang.org/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frezkhaleghi%2Fpj-player","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frezkhaleghi%2Fpj-player","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frezkhaleghi%2Fpj-player/lists"}