Troubleshooting

Having issues? Check these common problems and solutions.

Connection Issues

I can't connect to a source

1. Check that the host URL is correct
2. Verify your internet connection is working
3. The host server may be temporarily unavailable — try again later

A source shows as offline

The source's upstream service may be down. This is usually temporary. Check back in a few hours.

Authentication keeps failing

1. Double-check your username and password
2. Some sources require you to log in through their website first
3. Clear the saved credentials and try again: Settings > Sources > select the source > Clear Credentials

Reading Issues

Pages won't load

1. Check your internet connection
2. Try switching to a different chapter and back
3. The source may be experiencing issues — try a different source for the same title

Images are blurry or low quality

Some sources provide lower resolution images. If available, try adding the same title from a different source that offers better quality.

Tracking Issues

My progress isn't syncing

1. Verify the tracker is connected: Settings > Tracking
2. Check that the title is linked to the correct tracker entry
3. Manually refresh: open the title details and tap Sync Now

Wrong chapter count on tracker

The tracker and source may number chapters differently. You can manually adjust the chapter number in the tracking settings for that title.

App Issues

The app is slow or unresponsive

1. Close and reopen the app
2. Check if you have many titles in your library — consider archiving completed series
3. Ensure your device has sufficient storage space

How do I report a bug?

Visit the GitHub Issues page to report bugs or request features. Include:

• What you were trying to do
• What happened instead
• Your iOS version and device model