suwatte / suwatte

Manga/Comic Reading App for iOS

Suwatte

Suwatte is an ad-free, open source & feature-rich comic/manga reader for iOS.

Features

• External Comics (CBR, CBZ, RAR, ZIP)
• OPDS V1
• External Sources
• Progress Tracking
• Automatic Library Management
• Downloads
• Partial iCloud Sync
• Update Notifications
• Panel Bookmarks
• Extensive Reader Features
• External Sources
• Deep Linking
• Point Accurate Reading Resumption
• Library Management with Categories & Reading Flags
• Automatic Library Management
• Zero Ads, a few bugs n crashes here n there tho :]

Planned Features

• Full Library iCloud Sync Support
  • Due to crashes this feature was disabled.
• EPUB / Novel Reading Support

Installation

At the moment Suwatte is only available through TestFlight.

An App Store Release is planned later in the year.

Community

Join our Discord to converse with other manga/comic fans!

Screenshots

Contributing & Translations

Development initially started when I was learning Swift/SwiftUI/UIKIt so the codebase is very undocumented & hacky in some places (thanks a ton SwiftUI). If you have any questions feel free to ask them over on our discord's Development related channels or through Issues or Discussions here. :]

App-Wide Translations are planned and as the user base grows, it will become a core priority.

Disclaimer

Suwatte and its developer do not claim ownership of, nor are they affiliated with, any content submitted by users for reading within the app via external sources. Suwatte does not host any content and solely functions as a platform for users to organize and manage their subscribed titles in one application.

suwatte's Issues

[Bug] CloudFlare Resolution Button does nothing in Reader View

[Feature] Import Library from Tracker

[Bug] Marking All Chapters as "Read" does not update Library Entry's Unread Count

If you mark all chapters in a series as "read" and don't hit "done," Suwatte will remember that you've marked them as read, but the "unread" count in the library will still show all chapters as "unread."

[FEATURE] Export Chapter Downloads to files app

[Feature] Add parameter to CloudflareException to support resolve URL

Currently the resolve URL is part of the source config which is immutable at runtime. This would allow dynamic cloudflare resolving at runtime.

Proposed design on source side:

throw CloudflareException(faulty_url);

then CloudFlareErrorView would check if the url is provided and use that instead of the static URL if possible.

[Bug] Auto Tracking has no way to be disabled

Sources that provide the tracker keys will always auto-track.

[Bug] Webtoon Reader tends to display the loading symbol outside the viewable scope.

[BUG] iPadOS Always Double Pages

On an iPad in either RTL or LTR the app forces the double paged option to be on. Ideally this would be able to be customized in App Settings where panel mode is being set.

[BUG] OPDS Feed seems to be limited to 20 items per folder.

Just discovered your app and loving the speed and clean look. The Komga integration looks amazing (I made a request about read lists in that repo - but publisher, or series views would be great too).

Unfortunately when I loaded the OPDS feed from Komga, it is only listing 20 items per folder. For example, I have about 30 read lists, and only 20 folders are showing. Likewise, when I open a read list (or any "folder), it only shows 20 comics.

Looking forward to seeing this grow!

[Bug] TabBar Navigation Does Not Function

When in a nested view, tapping the tab bar should return the user to the initial view.

[Improvement] Image loading improvement

I've noticed some potential areas for improvement with image loading:

1. Occasionally, the next page loads before the current one, disrupting the reading flow and causing content to be lost.

2. The getChapterData function provides all image URLs in the gallery, but when navigating to a specific page, like the 500th image in an 800-image gallery, that image and surrounding ones aren't loaded. This functionality resembles another app called Paperback, where images load quickly as you scroll to them. Enhancing this aspect could significantly enhance the reading experience.

OPDS code license

Hi, would you be open to licensing the OPDS-specific parts of this codebase under a permissive license such as MIT? Specifically the ObservableObject related code. Thank you.

[TWEAK] Include Runner ID on Migrate View

Gives more context to the user about where they're migrating to & mitigates the annoyance found in #73.

[BUG] Lagging occurs intermittently when transitioning between images in horizontal reading mode

I've noticed this issue occurring frequently while reading manga in both RTL and LTR modes. Occasionally, there's a lag when transitioning between images. You can verify this by viewing the uploaded video.

Device: iPad Pro 11 Inch 2021
iOS Version: 16.2

RPReplay_Final1712237785.mov

[Feature] Add Filtering Options in the Library View.

Directory-Like Filtering Options in the Library/Library Collections View

[FEATURE] adding an unread chapters indication

It would be nice to have an indication on Collection screen to now how many unread chapters a title have.

be something like the tag with number of new chapters when there’s an update on a title.

[Bug] Migrating a library title removes the reference to the linked titles

Migrating a library title, removes the references to the linked title, but when you add one linked title again, it will add all the old ones too.

[Feature] Sorted/Sectioned Library Grid

Example: being able to have all manga with unread chapters at the top, sorted by the last time they were read.

[BUG] MacOS is unable to resolve CloudFlare

Bit of a strange bug. On MacOS Suwatte cannot resolve the cloudflare challenge, instead it just displays a blank page.

[Feature] Display Source/Tracker Version+Update Status in the Browse page

It is currently difficult to determine whether a source or tracker is out of date relative to the list it was installed from. Although runner's being out of date are indicated by an exclamation, there is no such indication for trackers.

It would be easier for users to track when their sources and trackers are can be updated by surfacing the "update" button, as well as the version number in the "browse" view, which already has a list of all the installed sources and trackers.

[BUG] Pages do not load and are replaced by colors.

This is a weird bug that I struggle to recreate. After a bit of reading (anywhere from 1 chapter to 1 hour of reading) images will not load and instead random colors that are the same height as the images will load where the image was supposed to be.

Initially I thought it was a runner problem but using my version of Bato or the community version will have this problem happen randomly. Closing the reader & reopening it solves the problem so it's not critical to fix.

[BUG] Image Processors not applied when chapter is downloaded

• Reported on Discord

When downloading chapters from sources that implement image processors. The downloaded images are not modified.

[BUG] Search can either search or order, not both.

On a runner search page you can either search with tags or change the sort, not both. I think it's because it's two different components making a call to change the directory request

[BUG]: URL Encode Check Fails

https://github.com/Suwatte/Suwatte/blob/main/iOS/Extensions/STT%2BURLRequest.swift#L24

only works when Content-Type is content-type and some websites require the first.

[Bug] Action State Button does not respect Chapter Provider Settings

[BUG]: Cannot Migrate all manga from source when runner has been uninstalled.

Example:
source.a has 100 followed entries but needs to be migrated to source.b. If source.a is uninstalled before this migration happens you cannot mass migrate source.a to source.b. These entries then just sit unable to check for updates or anything without notifying the user.