ddsderek/smanga

By ddsderek

•Updated almost 2 years ago

A simple cartoon browser

Image

7.9K

Overview Tags

ddsderek/smanga repository overview

⁠Smanga

无需配置，docker直装的漫画流媒体阅读工具。

以emby plex为灵感，为解决漫画阅读需求而开发的漫画阅读器。

⁠简介

github: https://github.com/lkw199711/smanga⁠

docker: https://hub.docker.com/r/lkw199711/smanga⁠

后端项目已转移: https://github.com/lkw199711/smanga-php⁠

在浏览漫画时,你是否有这样那样的烦恼？

图片压缩包 pdf等格式繁杂, 解压的文件到处都是, 经常找不到想看的漫画且占用空间大
阅读器无法很好的适应条漫, 图片之间有割裂
合订单行本一本几百页, 经常忘记自己看到哪了
想像emby一样拥有漂亮的流媒体电影墙, 这种方式去管理海量漫画资源
pt刷友为了保种, 下载的漫画不好手动解压, 需要一款流媒体管理软件
calibre-web等管理软件安装步骤繁杂, 到现在还没有成功使用上

您可以尝试一下smanga, 最新版3.0.0的升级, 带来了如下功能及支持

引入mysql数据库支持, 扫描以及检索漫画效率更高, 资源占用更少
新增解压缩转换功能, 支持(zip|cbz|cbr|7z|rar|pdf)
新增书签功能, 记录自己的阅读进度
新增历史功能, 可查看自己的浏览记录
对各尺寸设备的兼容, 现在您在手机、平板、pc等各种设备上使用smanga都可以获得良好的体验.
新增多种阅读模式, 条漫(瀑布流) , 翻页以及双页, 选择适合的浏览模式可提升阅读体验.

⁠安装

⁠1. 使用docker安装

⁠整合映射

docker run -itd --name smanga \
-p 3333:3306 \
-p 9797:80 \
-v /mnt:/mnt \
-v /route/smanga:/data \
lkw199711/smanga;

smanga的部署，仅映射一个data目录即可。

⁠推荐映射

docker run -itd --name smanga \
-p 3333:3306 \
-p 9797:80 \
-v /mnt:/mnt \
-v /route/smanga:/data \
-v /route/compress:/compress \
lkw199711/smanga;

通常我们在使用系统时，应用池与存储池是分开的，就好比我们不会在C盘储存大量的媒体资源。compress目录是解压缩文件的缓存目录，smanga将所有的压缩文件解压为图片放置在compress目录中。这些文件并非关键文件，丢失不会影响系统正常运行，但是会占用大量空间，因此建议您将此目录单独映射，而其余的目录保持默认即可。

⁠全目录映射

docker run -itd --name smanga \
-p 3333:3306 \
-p 9797:80 \
-v /mnt:/mnt \
-v /route/compress:/compress \
-v /route/poster:/poster \
-v /route/mysql:/var/lib/mysql \
-v /route/config:/config \
lkw199711/smanga;

参数	含义
`--name`	容器命名
`-itd`	交互模式后台启动避免容器停止
`-p 80`	Web管理界面端口
`-p 3306`	mysq数据库端口, 推荐映射, 方便管理数据
`-v /data`	整合目录，包含（compress,config,poster,mysql）与单独映射方式二选一
`-v /compress`	压缩转换目录（将zip cbz等压缩文件解压后存放在此目录读取，请挂在到对容量有信心的硬盘上。）
`-v /poster`	封面存储目录（解压缩后, smanga将提取一张图片作为封面，存放在次目录中。）
`-v /config`	配置文件存储目录
`-v /var/lib/mysql`	mysql数据目录（此目录必须映射, 否则升级smanga容器后, 将丢失所有数据。nosql版本的镜像无需映射。）
`-v /mnt`	mnt为linux系统（centos，debian，centos）通用挂载目录，您所有的外置硬盘一般都会挂载在此目录，映射此目录可使您镜像内外访问资源具有一致性。

⁠2.使用docker-compose进行部署

⁠以下给出一个compose文件示例

version: "3"
services:
  smanga:
    image: lkw199711/smanga:alpha
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 1G
        reservations:
          memory: 16M
    ports:
      - 9798:80
    volumes:
      - /route/smanga:/data
      - /route/compress:/compress
      - /mnt:/mnt
    environment:
      PUID: 1000    # 想切换为哪个用户来运行程序，该用户的uid
      PGID: 1000    # 想切换为哪个用户来运行程序，该用户的gid
      UMASK: 022
      TZ: Asia/Shanghai
    restart: unless-stopped
    hostname: smanga-alpha
    container_name: smanga-alpha

⁠macvlan部署示例

version: "3"
services:
  smanga:
    image: lkw199711/smanga
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 1G
        reservations:
          memory: 16M
    networks:
      macvlan_1:
        ipv4_address: 192.168.2.21
    ports:
      - 9798:80
    volumes:
      - /route/smanga:/data
      - /route/compress:/compress
      - /mnt:/mnt
    environment:
      PUID: 1000    # 想切换为哪个用户来运行程序，该用户的uid
      PGID: 1000    # 想切换为哪个用户来运行程序，该用户的gid
      UMASK: 022
      TZ: Asia/Shanghai
    restart: unless-stopped
    hostname: smanga-alpha
    container_name: smanga-alpha

networks:
  macvlan_1:
    external: true
    driver: macvlan

⁠3. LNMP环境安装

~~安装宝塔面板或是其他web环境（支持php），然后将web项目放入站点目录即可。~~

Smanga3版本以上, 新增了数据库以及压缩文件支持, 为此引入了许多库支持, 无法直接使用web项目安装, 请使用docker安装.

⁠使用

⁠默认用户名

默认用户名密码 smanga smanga

⁠新增媒体库

⁠媒体库管理->新增媒体库

媒体类型分普通和单本, 扫描时的目录结构有所区别

单本 (漫画目录=>图片)

单本结构没有章节, 少一层.

通过选择"文件夹结构", 可以是结构新增一层二级目录, 比如你想用年份分区

(/二级目录/漫画/章节/图片)

⁠添加路径

为媒体库添加媒体路径, 单个媒体库可以有多条路径 (添加时请注意目录的格式以及确认目录确实存在)

添加路径之后,smanga将开始扫描, 骚后点击logo可前往媒体库列表界面就可以观看漫画了

⁠添加书签

阅读时, 点击屏幕靠上30%的区域, 可以呼出顶栏, 最右侧为添加书签按钮. 之后再书签管理界面可以查看到.

⁠切换浏览模式

顶栏有切换模式的选择框, 可切换单页双页与条漫模式.

⁠阅读界面的使用

为最大程度的使用屏幕, 我采用了这种所有的除图片元素外都可隐藏的交互界面.

⁠初衷

励志做最好的流媒体漫画阅读平台!

貌似并没有这么多人有流媒体漫画需求, 我开发这东西的本意就是填补一个流媒体功能的空白.

如果你有大量的漫画资源, 却不能够随意预览观看, 那一定不是一件很舒服的事情.

于是乎, 当时我面临这种情况, 简单的开发了一款能够阅读条漫的浏览器.

后续熟练使用emby plex后, 对于这种流媒体服务已经形成依赖, 然而让我很不解的是, 这些优秀的流媒体产品并没有阅读漫画的功能. 我就将阅读器简单更改了一下, 添加了配置路径的功能, 形成了这款smanga.

⁠产品局限性

由于开发时间仓促，本产品有着很多缺点，请在使用时注意。

测试工作未能完善，如有bug请提交issues或加群反馈。谢谢！

⁠虽然为条漫开发, 但是并不支持长图条漫(需裁切)

我们使用的是web浏览器，每一条http请求受限于网络原因，是有容量限制的，大家在网上拿资源，经常会拿到长图条漫，也就是整图。1w px的长度，这样的图片容量5m起步，浏览器是不能够正常加载的。

我当时测试的情况是，内网可以用，外网看不了。

⁠最后

如果产品有帮助到您, 请给一颗star以示鼓励.

如果您有意见或建议, 请提交issues或pr, 亦或是加入群聊联系我.

或许有漫画流媒体需求的人不多, 但是一旦您有观看的需要, 就很难被满足, 因为这个东西并不像emby一样形成了生态. 资源也不太好找.

我的愿景是聚集相同爱好的人们, 形成俱乐部.

您可以加入smanga交流群:

QQ 交流群：534086782⁠

Telegram 交流群：https://t.me/+FFgQ7AMIdrg2M2Y1⁠

版本发布频道(tg)：https://t.me/smangachannel⁠

⁠版本更新记录

1.0 基础版。
- 1.1 列表页面手机端样式支持修正。
- 1.2 分页功能添加。
- 1.4 搜索功能添加。
2.0 支持pdf阅读。
3.0 新增数据库多格式支持以及多项新功能。
- 3.1.0 提供app sql下载。
  - 3.1.4 添加7z,修复shell参数。
  - 3.1.5 条漫模式新增书签支持。
  - 3.1.6 新增用户权限管理。
  - 3.1.7 外置sql设置错误问题。
  - 3.1.8 新增视图切换功能, 解决文字展示不全的问题。
  - 3.1.9 新增排序方式切换功能。
- 3.2.0 新增搜索功能；处理扫描错误。
  - 3.2.1 新增用户设置模块。
  - 3.2.2 修复缓存与排序的bug。
  - 3.2.3 新增收藏模块。
  - 3.2.4 修改数据库以适配表情文字。
  - 3.2.5 修改初始化流程
  - 3.2.6 新增对半裁切模式
  - 3.2.8 新增图片下载功能
  - 3.2.9 分页浏览模式新增图片缓存
- 3.3.0 使用laravel重构项目,并优化排序功能
  - 3.3.1 新增websocket功能,进行解压成功通知
  - 3.3.2 新增日志模块
  - 3.3.3 扫描系统做节流处理
  - 3.3.4 新增自动扫描时间设置
  - 3.3.5 修复扫描压缩文件错误
  - 3.3.6 紧急修复403错误
  - 3.3.7 新增标签功能
  - 3.3.8 新增漫画信息展示页面, 元数据扫描
  - 3.3.9 漫画管理新增搜索框
- 3.4.0 扫描时自动解压章节
  - 3.4.1 临时增加登出按钮
  - 3.4.2 移动端滑动翻页功能
  - 3.4.3 章节管理新增搜索框
  - 3.4.4 修复解压路径获取错误的问题
  - 3.4.5 漫画详情页面新增收藏按钮
  - 3.4.6 pageSize逻辑调整
  - 3.4.7 切换章节错误bug修复
  - 3.4.8 新增"继续阅读模块",准确定位"继续阅读"功能.
  - 3.4.9 修复在列表模式下无法上下滚动的bug.
  - 3.5.0 菜单分类并修改图表.
  - 3.5.1 扫描时自动提取封面.
  - 3.5.2 目录扫描方法替换.
  - 3.5.3 散图漫画封面删除bug修复.
  - 3.5.4 新增漫画排序逻辑.
  - 3.5.5 散图获取封面bug修复.
  - 3.5.7 完善图片错误处理.

⁠开发注意事项

此项目使用nodejs16运行,请注意版本

Tag summary

Recent tags

Content type

Image

Digest

sha256:3b2d02aae…

Size

183.9 MB

Last updated

almost 2 years ago

docker pull ddsderek/smanga:alpha