Metadata-Version: 2.1
Name: radio-active
Version: 2.2.0
Summary: Play any radio around the globe right from the terminal
Home-page: https://github.com/deep5050/radio-active
Author: Dipankar Pal
Author-email: dipankarpal5050@gmail.com
License: MIT
Project-URL: Source, https://github.com/deep5050/radio-active/
Project-URL: Upstream, https://api.radio-browser.info/
Description: <div align=center>
        <p align=center><img src=images/logo.png width=250px></p>
        <h1 align=center> RADIO-ACTIVE </h1>
        <p align=center> Play any radios around the globe right from your terminal </p>
        
        <p align=center>
        <img align=center src=images/example.png >
        <hr>
        <img alt="GitHub" src="https://img.shields.io/github/license/deep5050/radio-active?style=for-the-badge">
        <img alt="PyPI" src="https://img.shields.io/pypi/v/radio-active?style=for-the-badge">
        <img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/radio-active?style=for-the-badge">
        <img alt="CodeFactor Grade" src="https://img.shields.io/codefactor/grade/github/deep5050/radio-active/main?style=for-the-badge">
        
        </p>
        
        </div>
        
        ### Features
        
        - [x] Supports more than 30K stations !!
        - [x] Saves last station information
        - [x] Favorite stations (Aliasing)
        - [x] Supports user-added stations
        - [x] Looks minimal and user-friendly
        - [ ] Finds nearby stations
        - [ ] No external dependencies!
        
        
        ### External Dependency
        
        It needs [FFmpeg](https://ffmpeg.org/download.html) to be installed on your
        system in order to play the audio
        
        on Ubuntu based system >= 20.04 Run
        
        ```
        sudo apt update
        sudo apt install ffmpeg
        ```
        
        For other systems including windows see the above link
        
        #### Installing FFmpeg
        
        FFmpeg is required for this program to work correctly. Install FFmpeg by following these steps :-
        
        - On Linux - <https://www.tecmint.com/install-ffmpeg-in-linux/>
        - On Windows - <https://www.wikihow.com/Install-FFmpeg-on-Windows>
        
        
        ### Install
        
        Just run: `pip3 install --upgrade radio-active`
        
        I encourage you to install with pipx: `pipx install radio-active`
        
        ### Run
        
        Run with `radioactive --station [STATION_NAME]`
        
        ### Demo
        
        
        <a align=center href="https://asciinema.org/a/412285" target="_blank"><img src="https://asciinema.org/a/412285.svg" /></a>
        
        
        
        ### Options
        
        
        | Argument                     | Note                                 | Description                          | Default |
        | ---------------------------- | ------------------------------------ | ------------------------------------ | ------- |
        | `--station`, `-S`            | Required ( Optional from second run) | Station name                         | None    |
        | `--uuid`, `-U`               | Optional                             | ID of the station                    | None    |
        | `--log-level`, `-L`          | Optional                             | Log level of the program             | info    |
        | `--add-station` , `-A`       | Optional                             | Add an entry to fav list             | False   |
        | `--show-favourite-list`,`-W` | Optional                             | Show fav list                        | False   |
        | `--add-to-favourite`,`-F`    | Optional                             | Add current station to fav list      | False   |
        | `--flush`                    | Optional                             | Remove all the entries from fav list | False   |
        
        <hr>
        
        
        > `--station`, `-S` : Expects a station name to be played (if not provided it
        > will try to get the last played station). Example: "pehla nasha" ,
        > pehla_nasha, bbc_radio
        
        > `--uuid`,`-U` : When station names are too long or confusing (or multiple
        > results for the same name) use the station's uuid to play . --uuid gets the
        > greater priority than --station. Example: 96444e20-0601-11e8-ae97-52543be04c81
        
        > `--log-level`, `-L` : don't need to specify unless you are developing it. `info` , `warning` , `error` , `debug` 
        
        > `-F` : Add current station to your favorite list. Example: `-F my_fav_1`
        
        > `-A`: Add any stations to your list. You can add stations that are not currently available on our API. When adding a new station enter a name and direct URL to the audio stream. 
        
        ### Extra
        
        If you ever face a situation where radio-active quits but the audio (ffplay) runs in the background. Kill the process ID (PID) of ffplay. Run `ps -al` get the PID of ffplay and `kill [PID]`. I know you Know that :)
        
        
        ### Support
        <p align=center><a href="https://www.buymeacoffee.com/deep5050" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a></p>
        
        ### Acknowledgements
        
        <div>Icons made by <a href="https://www.freepik.com" title="Freepik">Freepik</a> from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a></div>
        
        <div align=center>
        <img src=images/footer.png>
        <p align=center> Happy Listening </p>
        <img src=https://forthebadge.com/images/badges/built-with-love.svg>
        
        <p align=center ><img align=center src=https://static.pepy.tech/personalized-badge/radio-active?period=total&units=international_system&left_color=black&right_color=green&left_text=TotalInstalls></p>
          
        </div>
        
        
Keywords: pyradios wrapper radios api shortwave internet-radio cli app
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.6
Description-Content-Type: text/markdown
