# TuneIn Rust Client Library
<p>
<a href="LICENSE" target="_blank">
<img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg" />
</a>
<a href="https://crates.io/crates/tunein" target="_blank">
<img src="https://img.shields.io/crates/v/tunein.svg" />
</a>
<a href="https://crates.io/crates/tunein" target="_blank">
<img src="https://img.shields.io/crates/dr/tunein" />
</a>
<a href="https://docs.rs/tunein" target="_blank">
<img src="https://docs.rs/tunein/badge.svg" />
</a>
</p>
<img src="./logo.png" />
This is a Rust client library for the [TuneIn Radio](https://tunein.com/) API.
## 🚚 Installation
Add the following to your Cargo.toml:
```toml
[dependencies]
tunein = "0.1"
```
## 🚀 Usage
Search for a station:
```rust
use tunein::TuneInClient;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = TuneInClient::new();
let results = client.search("alternativeradio.us").await?;
println!("{}", serde_json::to_string_pretty(&results)?);
Ok(())
}
```
See the [examples](./examples) directory for more examples.
## ✨ Features
- [x] Search
- [x] Browse categories
- [x] Browse stations by category
## 📝 License
MIT
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.