{"id":13714284,"url":"https://github.com/Gandum2077/PyEhViewer","last_synced_at":"2025-05-07T01:33:15.441Z","repository":{"id":102363454,"uuid":"196341226","full_name":"Gandum2077/PyEhViewer","owner":"Gandum2077","description":"iOS端 exhentai.org 阅读方案","archived":false,"fork":false,"pushed_at":"2021-02-20T14:24:21.000Z","size":5647,"stargazers_count":94,"open_issues_count":0,"forks_count":6,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-05-23T04:43:48.730Z","etag":null,"topics":["exhentai","python3","pythonista"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Gandum2077.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-07-11T07:19:55.000Z","updated_at":"2024-05-23T04:43:48.731Z","dependencies_parsed_at":null,"dependency_job_id":"133851f1-f534-41da-9ec1-db2e13232b16","html_url":"https://github.com/Gandum2077/PyEhViewer","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gandum2077%2FPyEhViewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gandum2077%2FPyEhViewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gandum2077%2FPyEhViewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gandum2077%2FPyEhViewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Gandum2077","download_url":"https://codeload.github.com/Gandum2077/PyEhViewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252796043,"owners_count":21805490,"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":["exhentai","python3","pythonista"],"created_at":"2024-08-02T23:01:56.299Z","updated_at":"2025-05-07T01:33:14.882Z","avatar_url":"https://github.com/Gandum2077.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# PyEhViewer\n\n**由于Pythonista作者已弃坑，本应用不再更新，请使用[JSEhViewer](https://github.com/Gandum2077/JSEhViewer)**\n\n提升[exhentai.org](https://exhentai.org)在 iOS 平台的阅读体验，并尽情使用其强大的搜索、评分、收藏、评论等诸多功能！  \n本应用基于 Pythonista 3 平台。在功能上对标 Android 平台的 EhViewer。另外，也选择在 JSBox 平台的孪生应用[JSEhViewer](https://github.com/Gandum2077/JSEhViewer)。\n\n## Features\n\n- 自动翻页，解放左酱右酱\n- 快捷搜索\n- 高级搜索\n- 边栏、搜索词收藏、直接打开 url 等快捷功能\n- 标签翻译\n- 打分、收藏、分享、评论\n- 可以导入已缓存的旧版本，或者将旧版本导到新版本，方便追更新\n- 缓存，缓存内容也可以搜索\n- 自适应屏幕\n- 阅读页面可以使用手势操作\n- 代码尽量模块化设计，所以你可以添加想要的任何功能！\n\n## 前提\n\n这是本人为了欣赏艺术、提升欣赏艺术的体验才写的，因此很遗憾，可能不适合对艺术没有追求的人。  \n本程序虽然前提设置有点复杂，但是程序本身的操作是一目了然的。\n\n**你必须满足以下前提才能使用 PyEhViewer:**\n\n1. (必要) [Pythonista 3](https://apps.apple.com/cn/app/pythonista-3/id1085978097)\n2. (必要) iPad。 **不支持 iPhone。**\n3. (必要) 可以访问 e-hentai.org 和 exhentai.org 的网络环境，并且不可以使用 MITM 软件。如果你使用代理，请注意可能需要设为全局代理或者手动添加以上两个网址，因为很多代理软件没有这两个网址。  \n   关于如何手动添加代理设置，举两个例子：  \n   例一 Quantumult：在配置文件加入`HOST-SUFFIX,e-hentai.org,PROXY,resolve-on-proxy`和`HOST-SUFFIX,exhentai.org,PROXY,resolve-on-proxy`。  \n   例二 Surge：在配置文件加入`DOMAIN-SUFFIX,e-hentai.org,Proxy`和`DOMAIN-SUFFIX,exhentai.org,Proxy`。\n4. (必要) 注册[e-hentai.org](https://e-hentai.org)账号，并确保可以访问[exhentai.org](https://exhentai.org)，然后请去[Hath Perks 页面](https://e-hentai.org/hathperks.php)点亮 Multi-Page Viewer 的 Hath Perk\n5. [设置界面](https://exhentai.org/uconfig.php)做以下设置：\n\n   - (必要)Front Page Settings 设为 Extended\n   - (必要)Thumbnail Settings 中的 Size 设为 Large\n   - (可选)Gallery Name Display 设为 Japanese Title (if available)\n   - (可选)Search Result Count 设为 50 results。此功能需要 Paging Enlargement I 的 Hath Perk\n\n## 安装和更新\n\n建议安装[stash](https://github.com/ywangd/stash)，然后通过 git 来安装和更新。`stash`必须要运行在 Python 2.7 环境下。\n\n- 安装\n\n```\ngit clone https://github.com/Gandum2077/PyEhViewer.git\n```\n\n请注意后面的.git 不要漏了\n\n- 更新\n\n```\ncd PyEhViewer; git pull\n```\n\n请注意需要先进入 PyEhViewer 的目录，如果你安装在别的地方，那么要对应的修改。  \n此方法只保证在你没有过编辑行为，仅运行过`main.py`时可用，如果出现`WARNING: there are uncommitted modified files and/or staged changes. These could be overwritten by this command. Continue anyway? [y/n]`的提示，那么你应该修改过里面的文件，如果你认为自己的修改并不重要，可以输入 y 继续。  \n更新完请看看 Readme，**因为不能保证更新一定是平滑升级，尤其是大版本升级**\n\n## 使用方法\n\n运行`main.py`即可。\n\n注意事项：\n\n- 请注意所有的数据库写入操作都是在图库关闭的时候进行的，所以如果不关闭图库就直接退出 Pythonista，那么这个图库就不会保存到数据库\n\n## 更新\n\n### 2020-01-16 版本：2.0\n\n- 此版本为大版本升级，不兼容之前的版本，请先运行`troublefix.py`，并选择“迁移到 2.0”\n- 优化 downloads 页搜索速度\n- 更新提示\n\n### 2019-12-05 版本：1.7 加入表示是否为隐藏图库的标记功能，bugfix\n\n- 用删除线表示隐藏图库\n- 修复各类 Bug\n\n### 2019-07-14 版本：1.6 加入评论功能，bugfix\n\n- 此次更新加入评论功能，因此 parse 版本升级，兼容版本 1.5 的旧图库，\n  如果要全部升级，使用`troublefix`里的`update_infos()`即可。\n- 修复评分以后的刷新 bug\n\n## TO-DO\n\n- [ ] 为逻辑分辨率更高的 iPad 调整测试 UI 适配\n- [ ] 适配 iPhone\n- [ ] 让没有 Multi-Page Viewer 权限的账号也能使用\n- [ ] 让游客也能使用\n- [ ] 缓存搜索支持‘-’号过滤语法\n\n## 已知 bugs\n\n- 如果出现`requests.exceptions.SSLError`: 1. 不可以使用 MITM 软件；2. 请检查代理软件，最好将 e-hentai.org 和 exhentai.org 加入代理列表，或者可以暂时设为全局模式，登录完成以后再改回来\n- 如果出现数据库错误（多为程序卡死强制关闭造成），运行`troublefix.py`里的“修复数据库”即可，如果 App 还能打开，也可以在设置里操作\n- 本应用已经可以在 iCloud Drive 文件夹中运行。但是仍然强烈不推荐这么做，因为本应用在使用的时候需要频繁地的增删文件，iCloud Drive 会把版本冲突的文件在后面加“2”，“3”……这样的标识然后同时保留，这很可能导致本应用用于判断文件数量的函数运算出错，继而程序出错。\n- 关于 MemoryError（参见[issue#3](https://github.com/Gandum2077/PyEhViewer/issues/3)）：Pythonista 自带的`html2text`有问题，请使用 stash 升级`html2text`\n\n## Contributing\n\n- 针对不同设备调整 UI 需要大量的人力，所以如果你在逻辑分辨率不为 1024\\*768 的设备上使用，不要忘了调整 UI 并贡献代码\n- 另一个重点问题是重构 parse 模块，使其适用于没有 Multi-Page Viewer 权限的账号\n\n## 截图\n\n![0.png](https://github.com/Gandum2077/PyEhViewer/blob/master/screenshots/0.png)  \n![1.png](https://github.com/Gandum2077/PyEhViewer/blob/master/screenshots/1.png)  \n![2.png](https://github.com/Gandum2077/PyEhViewer/blob/master/screenshots/2.png)  \n![3.png](https://github.com/Gandum2077/PyEhViewer/blob/master/screenshots/3.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGandum2077%2FPyEhViewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGandum2077%2FPyEhViewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGandum2077%2FPyEhViewer/lists"}