{"id":13835523,"url":"https://github.com/Dudemanguy/mpv-manga-reader","last_synced_at":"2025-07-10T07:32:28.340Z","repository":{"id":46547116,"uuid":"174228225","full_name":"Dudemanguy/mpv-manga-reader","owner":"Dudemanguy","description":"Manga reading script for mpv","archived":false,"fork":false,"pushed_at":"2025-05-01T16:33:42.000Z","size":134,"stargazers_count":140,"open_issues_count":5,"forks_count":5,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-05-25T13:05:20.967Z","etag":null,"topics":["mpv-scripts"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dudemanguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-03-06T22:03:59.000Z","updated_at":"2025-05-22T17:53:08.000Z","dependencies_parsed_at":"2024-02-08T22:18:00.134Z","dependency_job_id":"c7d79353-6928-4f1a-b409-db301dc12ddb","html_url":"https://github.com/Dudemanguy/mpv-manga-reader","commit_stats":{"total_commits":150,"total_committers":2,"mean_commits":75.0,"dds":"0.013333333333333308","last_synced_commit":"fb06931eed4092fa74a98266cd04fa507ea63e13"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Dudemanguy/mpv-manga-reader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dudemanguy%2Fmpv-manga-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dudemanguy%2Fmpv-manga-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dudemanguy%2Fmpv-manga-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dudemanguy%2Fmpv-manga-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dudemanguy","download_url":"https://codeload.github.com/Dudemanguy/mpv-manga-reader/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dudemanguy%2Fmpv-manga-reader/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264545168,"owners_count":23625404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mpv-scripts"],"created_at":"2024-08-04T14:01:04.285Z","updated_at":"2025-07-10T07:32:28.335Z","avatar_url":"https://github.com/Dudemanguy.png","language":"Lua","funding_links":[],"categories":["Other"],"sub_categories":[],"readme":"# mpv-manga-reader\nmpv-manga-reader is a script aimed at making mpv a usable manga reader (it also works great with LN scans). mpv is almost unrivalled at opening images and archives thanks to its high quality rendering, scaling, and shading capabilities, but there's no way internally for it to have something like a double page mode that people expect from manga reading software. Therefore, I created this script to help alleviate those shortcomings and hopefully convince you to finally abandon mcomix.\n\n## Usage\nNote: requires at least mpv 0.34 to function correctly. Just place `manga-reader.lua` in your scripts directory and then load up a directory of images or an archive. Non-images and archives are removed based on their extension. If you have some weird, special snowflake image/archive format, just let me know and I can add it to the array.\n\nBy default, starting mpv-manga-reader is bound to `y`. When turning the reader on, it will enter manga mode and single page mode (by default) and rebind some keys. Here are the defaults.\n\n* toggle-manga-reader: `y`\n* toggle-double-page: `d`\n* toggle-continuous-mode: `c`\n* toggle-manga-mode: `m`\n* next-page: `LEFT`\n* prev-page: `RIGHT`\n* next-page-mouse: `MBTN_FORWARD`\n* prev-page-mouse: `MBTN_BACK`\n* next-single-page: `Shift+LEFT`\n* prev-single-page: `Shift+RIGHT`\n* skip-forward: `Ctrl+LEFT`\n* skip-backward: `Ctrl+RIGHT`\n* first-page: `HOME`\n* last-page: `END`\n* pan-up: `UP`\n* pan-down: `DOWN`\n* jump-page: `/`\n\nKeybindings can all be changed in input.conf in the usual way (i.e. `key script-message function-name`). If manga mode is false, then the direction keys of the `next-page` and `prev-page` functions are reversed (i.e. `next-page` becomes `RIGHT` and so on).\n\n## jump-page\nThe `jump-page` function will open the console and prompt the user to enter a page number to move to. Simply press any combination of numbers followed by `ENTER` to move to the desired page. If the entered number is out of range, or the input is invalid (not all numbers), a message will be displayed. Either way, the console will be closed. You can press `ESC` to close the console at any time.\n\n## Configuration\n`manga-reader.lua` reads its configuration from `manga-reader.conf` in your `script-opts` directory. The format for the file is `foo=value`. Here are the available options and their defaults.\n\n``auto_start``\\\nDefaults to `no`. Automatically start the reader if valid images are detected.\n\n``continuous``\\\nDefaults to `no`. Tells the manga reader whether or not to start in continuous mode. This is mutually exclusive with double page mode.\n\n``continuous_size``\\\nDefaults to `8`. This is the amount of pages stacked together for each chunk in continuous mode. Note that you will probably encounter a render error if you set the size too large.\n\n``double``\\\nDefaults to `no`. Tells the manga reader whether or not to start in double page mode. This is mutually exclusive with continuous mode.\n\n``manga``\\\nDefaults to `yes`. Tells the manga reader whether or not to start in manga mode (i.e. read right-to-left or left-to-right).\n\n``pan_size``\\\nDefaults to `0.05`. Defines the magnitude of pan-up and pan-down.\n\n``similar_height_threshold`` \\\nDefaults to `50`. This is the threshold used for determining whether or not to to display two pages in double page mode. The lavfi-complex filter requires that both video streams be exactly the same height when stacking the videos horizontally. It is common for scans to have slightly differing sizes so internally a scale filter is used with the lavfi-complex filter. The default threshold here just means that two consecutive pages whose difference in height is within 50 pixels is considered a valid double page.\n\n``skip_size``\\\nDefaults to `10`. This is the interval used by the `skip-forward` and `skip-backward` functions.\n\n``trigger_zone``\\\nDefaults to `0.05`. When in continuous mode, the manga reader attempts to be smart and change pages for you once a pan value goes past a certain amount (determined by the page dimensions and the vertical alignment). The `trigger_zone` is an additional value added to this parameter. Basically, increasing the value will make it take longer for panning a page to change pages whereas decreasing does the opposite.\n\n## License\nGPLv3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDudemanguy%2Fmpv-manga-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDudemanguy%2Fmpv-manga-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDudemanguy%2Fmpv-manga-reader/lists"}