# Monochrome Instances

This document lists public instances of Monochrome that you can use. Instances are community-hosted versions of Monochrome that provide access to the application.

---

## Official Instance

The official Monochrome instance maintained by the core team:

| URL                                                    | Status   | Notes            |
| ------------------------------------------------------ | -------- | ---------------- |
| [monochrome.tf](https://monochrome.tf)                 | Official | Primary instance |
| [monochrome.samidy.com](https://monochrome.samidy.com) | Official | Secondary mirror |
| [lossless.wtf](https://lossless.wtf)                   | Official | Failover mirror  |

---

## Community Instances

PLEASE do not use any rehost of monochrome and complain to us about features not working. They are usually out of date, and do not provide the latest features, and accounts are always broken.

## API Instances

Monochrome uses the Hi-Fi API under the hood. Live, up-to-date status trackers (which return JSON) can be found below:

- [https://tidal-uptime.jiffy-puffs-1j.workers.dev](https://tidal-uptime.jiffy-puffs-1j.workers.dev/)
- [https://tidal-uptime.props-76styles.workers.dev](https://tidal-uptime.props-76styles.workers.dev/)

These are available API endpoints that can be used with Monochrome or other Hi-Fi based applications:

### Official & Community APIs

| Provider          | URL                                 | Notes                                                                                                  |
| ----------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Monochrome**    | `https://monochrome-api.samidy.com` | Official API                                                                                           |
|                   | `https://api.monochrome.tf`         | Official API                                                                                           |
| **geeked.wtf**    | `https://hifi.geeked.wtf`           | Community hosted - uses the [TypeScript Rewrite](https://github.com/monochrome-music/hifi-api-workers) |
| **Lucida (QQDL)** | `https://wolf.qqdl.site`            | Community hosted                                                                                       |
|                   | `https://maus.qqdl.site`            | Community hosted                                                                                       |
|                   | `https://vogel.qqdl.site`           | Community hosted                                                                                       |
|                   | `https://katze.qqdl.site`           | Community hosted                                                                                       |
|                   | `https://hund.qqdl.site`            | Community hosted                                                                                       |
| **Kinoplus**      | `https://tidal.kinoplus.online`     | Community hosted - [Limited/No-Sub](https://rentry.co/limitedtidalaccs)                                |

---

## Adding Your Instance

Want to add your instance to this list?

1. Ensure your instance is stable and publicly accessible
2. Open a pull request with your instance details
3. Include:
    - Instance URL
    - Provider name
    - Type (UI/API/Both)
    - Brief description

---

## Disclaimer

- Community instances are not affiliated with the official Monochrome project
- Use at your own risk
- Instance availability and performance may vary
- The official project does not guarantee uptime for community instances

---

## Related Resources

- [Contributing Guide](CONTRIBUTING.md) - Contribute to the project
- [Main Repository](https://github.com/monochrome-music/monochrome) - Source code
