Adding a repository
Go to Settings → Sources and tap Add Repository, then enter its address. The first time, Honya asks you to read and agree to what third-party content means.
Addresses Honya accepts
Section titled “Addresses Honya accepts”Any of these work:
| What you enter | Example |
|---|---|
The folder that holds the repository’s index.json |
https://example.com/honya/ |
The index.json itself |
https://example.com/honya/index.json |
| A GitHub repository | https://github.com/someone/their-sources |
| A branch or folder of a GitHub repository | https://github.com/someone/their-sources/tree/beta |
For a GitHub repository, Honya reads index.json from its repo branch first, then from its default branch. That’s where the publishing workflow puts it.
Finding a repository
Section titled “Finding a repository”Honya doesn’t list or recommend repositories, and it comes with none. Repositories are made by the people who write sources, and they share the address themselves: on their website, their GitHub page or in their community. Copy it from there and add it in Honya.
Before you add one, think about who makes it. Sources are scripts that can see what you browse in them, so only add repositories you trust. See How sources work.
To try Honya before you find one, add the example repository at https://github.com/HonyaApp/Extensions. Its sources read public-domain comics and Pepper&Carrot, which are free to read.
You can also make a repository without writing code: an AI agent ports the sources from Keiyoushi’s Mihon extensions for you. See Making a repository with AI. To write sources yourself, see Quick start.
Choosing sources
Section titled “Choosing sources”Once a repository is added, its sources are listed with the ones in your languages first. Tap Get to install one.
- Show All Languages lists sources in other languages too.
- A source with several languages can be installed in each you want. Swipe a language to remove it.
- Sources marked 18+ can show adult content. They’re hidden until you turn on Show 18+ Sources in the filter menu, which checks your age first. See Adult content.
- Needs a newer app means the source needs a newer version of Honya.
If your library has titles from a source your repositories offer but you haven’t installed, such as after restoring a backup, the Sources screen offers to install it.
Managing repositories
Section titled “Managing repositories”Tap a repository to see its sources, copy its address, or remove it. Removing a repository keeps the sources you installed from it, and their titles stay in your library.
With iCloud Sync on, your repositories and installed sources are the same on all your devices.
Sources Honya removed
Section titled “Sources Honya removed”Honya can remove a source or repository after reports, for example one that shows illegal content or adult content that isn’t marked 18+. You’ll see Removed by Honya and the reason where it was listed.
- A removed source can’t be installed. If it’s installed already, Honya stops loading it and hides its titles in your library, history and updates. You can remove it from Settings → Sources.
- A removed repository offers no sources and can’t be added again, and the sources installed from it stop loading too. If another repository offers the same source, you can install it from there.
To report a source or repository, go to Settings → Report a Source or Repository.
Trying out your own repository
Section titled “Trying out your own repository”While you’re writing a source, you can serve your repository from your Mac and add it by its local address. See Quick start.