4.0 KiB
Manga Resolution Module
How to integrate manga title discovery, chapter listings, and high-resolution page resolution using the Vyla SDK.
Overview
In addition to video streaming, @vyla-entertainment/sdk includes a native Manga resolution module. Powered by atsu.moe and leveraging node-tls-client, the module bypasses anti-bot TLS fingerprinting by mimicking real Google Chrome 131 cryptographic handshakes.
This allows developers to build responsive, ad-free manga reading interfaces directly into their applications.
Technical Architecture
Upstream manga archives frequently block standard Node.js fetch or axios requests using JA3/JA4 TLS fingerprinting. To ensure reliable connectivity:
- TLS Emulation: Uses
node-tls-clientconfigured withClientIdentifier.chrome_131. - Session Persistence: Reuses keep-alive TLS sessions across search and chapter page requests.
- Structured Geometry: Returns explicit image dimensions (
width,height) and pre-calculated aspect ratios so mobile and desktop readers can prevent layout shifts during image loading.
Manga Methods
1. Searching for Titles
Search the manga catalog by query string with pagination support:
import VylaSDK from '@vyla-entertainment/sdk';
const sdk = new VylaSDK();
const searchResult = await sdk.searchManga('Chainsaw Man', 1, 10);
console.log(`Total results: ${searchResult.total}`);
searchResult.results.forEach((manga) => {
console.log(`[ID: ${manga.id}] ${manga.title} (${manga.status})`);
});
Search Response Structure
{
"page": 1,
"total": 42,
"results": [
{
"id": "chainsaw-man",
"title": "Chainsaw Man",
"englishTitle": "Chainsaw Man",
"authors": ["Tatsuki Fujimoto"],
"type": "Manga",
"medium": "MANGA",
"status": "Ongoing",
"year": 2018,
"rating": 8.7,
"popularity": 120000,
"poster": "https://cdn.atsu.moe/static/covers/chainsaw-man.webp",
"posterSmall": "https://cdn.atsu.moe/static/covers/chainsaw-man-sm.webp",
"posterMedium": "https://cdn.atsu.moe/static/covers/chainsaw-man-md.webp"
}
]
}
2. Fetching Manga Details & Chapters
Retrieve full metadata, synopsis, genres, and the complete chapter index:
const mangaDetails = await sdk.getManga('chainsaw-man');
console.log('Title:', mangaDetails.title);
console.log('Synopsis:', mangaDetails.synopsis);
console.log('Genres:', mangaDetails.genres.join(', '));
console.log('Available Chapters:', mangaDetails.chapters.length);
const latest = mangaDetails.chapters[0];
console.log(`Latest Chapter: ${latest.number} (ID: ${latest.id})`);
3. Resolving Chapter Pages
To render the reader view, fetch the ordered page image assets for a specific chapter:
const mangaId = 'chainsaw-man';
const chapterId = 'chapter-1';
const chapter = await sdk.getMangaChapter(mangaId, chapterId);
console.log(`Chapter ${chapter.number} contains ${chapter.pages.length} pages.`);
chapter.pages.forEach((page) => {
console.log(`Page ${page.number}: ${page.url} [${page.width}x${page.height}]`);
});
Chapter Response Structure
{
"id": "chapter-1",
"number": 1,
"title": "Dog & Chainsaw",
"scanlatorId": null,
"pages": [
{
"number": 1,
"url": "https://cdn.atsu.moe/static/data/.../01.webp",
"width": 1080,
"height": 1600,
"aspectRatio": 0.675
}
]
}
Reader Layout Best Practices
When rendering manga pages in a frontend reader:
- Prevent Cumulative Layout Shift (CLS): Use the provided
aspectRatioorwidth/heightin CSS (aspect-ratio: attr(width) / attr(height);) to reserve vertical scroll space before each image finishes downloading. - Preload Neighboring Pages: Implement a 2-page lookahead preloader so viewers turning pages experience instantaneous transitions.
- Session Cleanup: In long-running background tasks, invoke
cleanup()fromsrc/manga/atsu.jswhen closing reader sessions to terminate idle TLS sockets.