Mangadex

usage for Riku

• open Terminal -> NixOS
• nix run 'github:askabaria/mangadex' --refresh -- --auto <your urls>
• nix run 'github:askabaria/mangadex' --refresh -- --auto https://mangadex.org/title/33ffea1c-1dbd-4355-b318-465601c1f061/she-doesn-t-know-why-she-lives https://mangadex.org/title/1ef9112e-3159-455e-9e11-85a55a0b98ae/for-imperfect-people
• a different root directory can be specified with --target /mnt/c/Users/...

BONUS: MERGER

merges multiple pages with special rules

you can pass flags to modify the behavoir

• nix run 'github:askabaria/mangadex'#merger --refresh -- --help
• nix run 'github:askabaria/mangadex'#merger --refresh -- --target ...

Flags:

• --target works like the fetcher, says "where" to work
• --language focus only on specific languages
• --filter "Lives;Hito;..." separate search terms by ;, when given ONLY works on mangas matching at least one of the filters
• --skip-double-pages when given, skips the logic for double pages
• --double-page-ratio 1.1 you can change the trigger-ratio when a page is seen as such (1 is square, above 1 is wider, below 1 is higher)
• --show-ratio shows you the calculated ratio of each page (for debugging purposes)
• --no-even-odd disables filler pages preceding detected double pages
• --even-odd flip the even-odd counting for double-page fillers
• --dry-run prints the commands it would execute to produce the requested pdf's
  • can be piped into a file and executed as a script

BONUS: PDF-cat (meow)

merges all existing files into the given filename that does not exist

• same same:
• nix run 'github:askabaria/mangadex'#pdfcat --refresh -- One.pdf Two.pdf Three.pdf Output.pdf
• nix run 'github:askabaria/mangadex'#pdfcat --refresh -- Output.pdf One.pdf Two.pdf Three.pdf
• just make sure your output file doesn't exist

usage-cycles

• cloned
  • git pull to get the latest updates
  • nix run . to get the GUI
  • nix run . -- <arguments-go-here> to execute automated tasks
• automatically
  • just use nix run 'github:askabaria/mangadex' (-> specify the url instead of . as the source)
  • you can also pass nix run --refresh https://... to check if there's a new version available
  • everything else works just as above

dev-cycles

• have direnv installed, set up and allowed (will make node, npm, etc. available to your shell and editor)
• nix run . -- <arguments-go-here> runs main application
• npm run update-lockfiles when building complains about outdated locks (usually after installing an npm-package)

@application plan

• Stored configuration
  • defines what you wish to mirrow locally with what filters applied
  • managed via script/user-interface
  • used by API-client when triggered
• API client
  • rate-limited service-wrapper usable in resolving pipe
• reactive friendly user-interface (fzf? bypassable/navigatable via arguments for scriptability)
  • overview with different actions
    • list of declared + updating info of availability
    • different actions to take
      • "refresh" -> execute stored configuration and load what's missing
      • "show" -> compile an overview to inspect and modify
      • "add" -> opens interactive search to add to your config

@extended plans

• visual preview for searches and "show" mode

resources

ID	Resource	Description
0	https://mangadex.org/title/1ef9112e-3159-455e-9e11-85a55a0b98ae/for-imperfect-people	URI sent as example for content to mirror
1	https://mangadex.org/	Website to mirror content from
2	https://api.mangadex.org/docs/	API documentation to be used
3	https://nix-community.github.io/NixOS-WSL/install.html	Want to use this tool on windows?