Matane 1.1.0

Smoother motion, right-click menus almost everywhere, a quicker Browse and a clearer view of what downloads use.

Interface

• Motion: dialogs, the confirm dialog, page changes and the sidebar animate in and out, the active tab underline slides, and selection bars animate.
• Right-click menus: library cards, rows and category tabs, manga cards and sources in Browse, chapter rows, updates and history entries, the download queue and completed downloads, extensions and repositories. Text fields get a native menu (cut, copy, paste).
• Toasts tell you when something was copied, data was cleared or a bulk action failed.
• Latte theme: coloured text stays readable.
• Library: placeholders while loading now have the shape of the display you chose.
• Updates: entries are marked as seen on purpose instead of by opening the page.
• Language: the tray, notifications and the Discord status follow your language, and so do repository and install errors.

Browse

• The last Popular and Latest are shown while the source answers, and a manga is fetched ahead when you hover its card.
• A redesigned filter panel that also sends the filter defaults; the sources you used last are listed first.
• Browse rows nobody kept are dropped after two weeks.
• Covers in Browse time out sooner and retry once. The next page is no longer requested again while the last request failed.
• An adult source's filters are not read while adult content is hidden.

Downloads, data and network

• A storage card shows what downloads use, the free space and the folder.
• Settings → Data & storage can clear the reading history.
• The connection test says why it failed.
• Backups: a relative backup folder is ignored, a clock set back no longer upsets the schedule, and the schedule starts once.

Extensions

• A developer folder that replaces an installed copy is announced, and installing over one is refused, as are two developer folders for the same extension.
• Installed files that changed after the install are refused.
• A repository index can list the oldest app version an extension needs and its icon hash.

Matane 1.0.0

The first stable release. It is the 1.0 release candidate with one change: new installs follow stable releases by default.

What is in 1.0

• Reading: a reader for paged manga and webtoons with zoom, colour filters, remappable keys, auto-scroll and per-manga settings; your own CBZ files and folders as a source of their own.
• Library: categories, unread counts, automatic update checks with notifications and downloads, history and statistics, a command palette, backup and restore (and import of Mihon backups).
• Sources: nothing is built in. You add extension repositories you trust; extensions run in a sandbox and ask before reaching a website. Extension authors get an SDK and ready-made templates for Madara and MangaThemesia sites.
• Trackers: AniList, MyAnimeList, Kitsu and MangaUpdates, with two-way sync (what you read elsewhere is marked read here, and the other way around).
• Yours: four themes, English and Indonesian, optional proxy and DNS-over-HTTPS, no telemetry; Discord Rich Presence is off unless you turn it on.

Updates

• New profiles follow the stable releases. A profile that chose beta (Settings → About → Updates) keeps receiving pre-releases.

Matane 1.0.0-rc.1

The release candidate for 1.0: on top of the 0.2 beta it adds reading from your own files, more trackers with two-way sync, and templates for extension authors. Please try it and tell us what breaks; 1.0.0 follows once nothing does.

Reading

• Local files: read CBZ files and folders of images from your computer as a source of their own. Pick the folder in Settings → Browse & extensions → Local files; it has one folder per manga, with chapters as .cbz/.zip files or sub-folders of images, an optional cover.jpg and ComicInfo.xml details. Add the manga to the library, keep progress and history, and read with the same reader. Matane only reads inside the folder you chose.

Library and trackers

• Two-way tracker sync: chapters you read on a tracker (on your phone, or on its website) are marked read here, a tracker that is behind gets an update, and the status, score and dates you change on its website are taken over. It runs after the app opens and after the library is checked, and with Sync now in Settings → Tracking or in a manga's Tracking dialog. Following a tracker can be switched off per tracker and per manga. Nothing read here is sent while incognito, and what a tracker said is never sent back to it.
• Kitsu and MangaUpdates tracking: log in with your username and password in Settings → Tracking (the password goes only to that service and is never kept), link manga from their page, and reading is sent the same way. Kitsu rates in halves; MangaUpdates has no dates.
• MyAnimeList tracking (in builds that have a MyAnimeList app registration): the same as AniList, with a login that renews itself, whole-number scores, and a title search of at least 3 letters.
• AniList tracking: connect AniList in Settings → Tracking (the login happens in your browser), link a manga to its AniList entry from its page (Tracking), and the chapters you read are sent for you. Edit status, score, chapters read and dates there too. Nothing waits on the network: updates are queued, sent when AniList can be reached and retried if it is down, and never sent while incognito. Links are in your backups; the login is not.

Extensions

• Templates for Madara and MangaThemesia sites: the new @matane/extension-templates package gives extension authors a ready-made source for each theme, and mr-ext create <id> --template madara|mangathemesia scaffolds an extension that is one line of configuration. Paths and CSS selectors can be adjusted, or a single method replaced. The templates follow each theme's default markup. See the extension guide.
• Extension SDK 0.3.0: @matane/extension-sdk, -runtime, -templates and -cli are published together at 0.3.0, the first release of @matane/extension-templates. The extension API version is unchanged, so extensions built for 0.2 keep working.

Matane 0.2.0-beta.1

The second beta: sources now come from extension repositories you add, and most of the polish planned for 1.0 is in. Nothing is built into the app, and no repository is added for you.

Reading and library

• Pages are measured, cropped and cut in the background: no more jumping strip, optional automatic border cropping, and very tall pages shown in parts (smoother webtoons). Downloads stay untouched.
• Zoom (Ctrl+wheel, Ctrl +/−/0, double-click) and drag around a zoomed page; on touch screens, swipe to turn pages and pinch to zoom.
• Every reader key can be remapped (Settings → Reader → Keyboard shortcuts).
• Colour filters (brightness, contrast, warm tint, grayscale, invert) and a custom background, also per manga; a page number while the bars are hidden; auto-scroll for webtoons.
• Default reading mode and direction per kind of manga (manga, manhwa, manhua, comic).
• Right-click a page to save or copy it.
• Webtoon and vertical modes read on in both directions: scrolling up continues into the previous chapter, and the previous/next chapter keys scroll within the strip instead of reloading the reader. Chapters far from the one on screen are unloaded.
• The manga page takes its colour from the cover.
• A source's manga list has a cover size slider and the same display modes as the library (comfortable grid, compact grid, covers only, list); the choice is remembered.
• Statistics: chapters read, reading time, streaks, favourite genres and sources over 30 days, 12 months or all time.

Getting around

• Command palette (Ctrl+K): pages, settings, your library, recent chapters and actions.
• A short first-run setup (language, theme, content languages, download folder, sources), which can run again from Settings → About.
• What's new: these notes show once after an update, also offline.
• Discord Rich Presence (off by default; hidden for adult sources and in incognito).

Network and data

• Settings → Network: DNS-over-HTTPS (Cloudflare, Google, Quad9, AdGuard or your own), HTTP/SOCKS5 proxy, a custom User-Agent, and a connection test. Useful where providers block sites through DNS.
• Backup and restore: one file with your library, progress, history, statistics, repositories, extension settings and app settings; merge or replace; daily automatic backups (the last 7 kept).
• Restore can also import a Mihon/Tachiyomi backup (.tachibk): library, categories, read chapters, bookmarks, progress, history and reading time. Each source in the backup is matched to an installed source (by Mihon's source id, else by name) and can be changed or skipped in the dialog (an extension that is not installed yet can be installed from there when a repository has it); manga of skipped sources are reported, not imported. Trackers, repositories and app settings are not imported.

Diagnostics and packages

• Settings → Advanced: log level, the log and crash report folders (crash reports never leave your computer) and "Copy debug info" for bug reports, without your home folder or tokens.
• Settings → About: how Matane was installed, the open source licenses, and links to the documentation and issue tracker.
• New downloads: Windows portable, deb, rpm and tar.gz. Builds that cannot update themselves tell you when a new version is out.
• Documentation site: sukundev.github.io/matane.

Extensions

• Matane does not ship with, link to, or add any extension repository by itself. Add one by its URL (Extensions → Repositories); a repository is either signed with a key you chose to trust or unverified.
• Extension repositories: add one by its URL, see what it offers, install, update ("Update all") and uninstall extensions. Every repository index is signed (ed25519), unverified ones are asked about before adding and warned about before installing. Every archive must match the signed SHA-256 before anything is written.
• The install dialog shows the repository's trust, its API version and size. Extensions no longer declare the sites they reach: requests are limited to http(s) and still go through the app, so install only extensions from repositories you trust.
• Uninstalling removes an extension's settings, data and cookies; its manga stay in the library as "source not installed" until it comes back.
• Content languages and adult content: extensions and sources in other languages, and adult ones until you turn them on, are hidden in Extensions, Sources, browse, global search and migration.
• Settings → Browse & extensions: content languages, adult content, updating extensions by themselves, how often repositories are checked, and the repository list.
• A live log per extension (its own lines, every request and failed call), with level filter, copy and clear.
• Sites that scramble or encrypt their images work: extensions describe how to restore a page (transformImage, with crypto.aesDecrypt), the app rebuilds it; restored pages are cached and downloaded as they are shown.
• Extension updates can change how their links look without breaking the library, progress or downloads (migrateUrl).

For extension authors

• mr-ext repo keygen | build | verify: reproducible, signed repositories for static hosting (GitHub Pages).
• mr-ext test runs transformImage on the first page and writes the restored page to .mr-ext/; it also accepts built bundles. mr-ext create --layout standalone | catalog | workspace.
• The packages are now @matane/extension-sdk, @matane/extension-runtime and @matane/extension-cli, published on npm.
• Guide for writing extensions and publishing a repository of your own: the extension guide.

Fixes

• The Library filter menu scrolls instead of running off short windows.