LocalViewer

zmz125000GPL-3.0活跃维护

Android 上直接浏览 NAS 里 SMB/WebDAV 共享的漫画、电子书和照片,支持 CBZ、RAW、EPUB 及视频播放,不用先下载到本地。

LocalViewer is a fast and full-featured Android SMB/WebDAV/CBZ/RAW photo/comic/ebook viewer and video player with folder and library support.

1.13.29发布于 2026-11-08 03:10 UTC220star +6 / 7 天11fork同步于 2026-11-10 18:04 UTC

怎么上手

由 README 提炼,执行前请确认
从 https://github.com/zmz125000/LocalViewer/releases/latest 下载 APK 安装
硬件要求按 README 说明

Android 12 起可装基础版;HDR、GPU Shader、RAW 需 Android 14 且为 arm64-v8a 或 x86-64。README 未提及显存或桌面 GPU 要求。

支持 Apple Silicon
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

Android 上的 SMB/WebDAV 图片漫画电子书查看器,直连网络文件夹看图看片

Android 上直接浏览 NAS 里 SMB/WebDAV 共享的漫画、电子书和照片,支持 CBZ、RAW、EPUB 及视频播放,不用先下载到本地。

核心能力

  • 支持 SMB/WebDAV 网络文件夹与本地库,添加文件夹即可用
  • 用 mmap 即时读取 ZIP/RAR/CBZ/CBR/CBT/PDF/EPUB 压缩包
  • 解码 16 位 RAW 并输出真 HDR,支持 JXL/JXR/AVIF/HEIC
  • GPU shader 实现 Lanczos3 等多种图像缩放算法
  • 内置 HTTP 服务器在浏览器打开离线 HTML 网站存档

容易踩的坑

HDR/RAW/GPU Shader 功能需 Android 14 的 arm64-v8a 或 x86-64 版本,旧系统装默认版没有这些能力;WebDAV 需自备服务器,README 示例用 rclone serve webdav 并配自签证书;SMB3 加密需在服务端开启 EncryptData 并调整 RejectUnencryptedAccess。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本1.13.29
  1. 1.13.29最新正式版2026-11-08 · 2026-11-08 03:10 UTC
    1. Added image conversion HLG output targets.
    2. Added file deletion toggle.
    3. Faster HEIF.
    4. Bugfixes.

    The desktop version of LocalViewer's HDR image converter is here. https://github.com/zmz125000/JXRConverter

    It supports float32 HDR conversion pipeline (including RAW photo path), batch outputs to JPG, JXR, JXL, PNG, AVIF in scRGB, HLG, PQ and Ultra HDR transfers.

    Full Changelog: https://github.com/zmz125000/LocalViewer/compare/1.13.28...1.13.29

  2. 1.13.282026-11-06 · 2026-11-06 10:50 UTC
    查看更新说明
    1. Upload to local folder directly.
    2. Allow folder deletion.
    3. USB OTG storage.

    v1.13.26

    1. Added image conversion sRGB clamp toggle.
    2. Added RAW auto exposure.
    3. Added HDR PNG supports.

    Full Changelog: https://github.com/zmz125000/LocalViewer/compare/1.13.26...1.13.28

  3. 1.13.261.13.26 Stable2026-11-04 · 2026-11-04 14:38 UTC
    查看更新说明
    1. Added image conversion sRGB clamp toggle.
    2. Added RAW auto exposure.
    3. Added HDR PNG supports.
    4. Bugfixes.

    FAQ

    https://github.com/zmz125000/LocalViewer/releases/tag/1.12.7

    Long press zones:

    1. Library tab, long press the Photo/Video header or the library tab icon.
    2. Any screen, long press the grid mode icon to switch between grid and list view mode.
    3. Long press anything (like a gallery) for alt opens.
    4. Long press the folder view headers to select all.
    5. Long press the folder view overflow menu content filters (photo, video etc.) to lock it for the current folder.
    6. Long press the folder view overflow virtual gallery.
    7. Long press the window manager header text to close all windows.

    Full Changelog: https://github.com/zmz125000/LocalViewer/compare/1.13.23...1.13.26

  4. 1.13.242026-11-04 · 2026-11-04 05:29 UTC
    查看更新说明
    1. Added image conversation sRGB clamp toggle.
    2. Added Raw auto exposure.
    3. Reduced Raw RAM usage.

    Full Changelog: https://github.com/zmz125000/LocalViewer/compare/1.13.23...1.13.24

  5. 1.13.231.13.23 JXRConverter2026-11-01 · 2026-11-01 15:34 UTC
    查看更新说明

    The desktop version of LocalViewer's HDR image converter is here. https://github.com/zmz125000/JXRConverter

    1. Added deletion.
    2. Added delete trash folder.
    3. Added support for HDR PNG.
    4. Added Float32 image conversion processing.
    5. Added JXL scRGB HDR output target.

    Full Changelog: https://github.com/zmz125000/LocalViewer/compare/1.13.22...1.13.23

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Description

    A High performance Android SMB/WebDAV image viewer/comic reader with network gallery folder support.

    The app features advanced image options, including support for RAW, HDR, WCG, slideshow and fast video thumbnails, with a clean interface for daily use.

    Based on EhViewer
    With Material Design 3
    and Dynamic Color Support.

    Similar to Perfect Viewer and Kuro Reader, with Hi-Res images support (no downscaling) and good performance.

    The desktop version of LocalViewer's HDR image converter is here.
    https://github.com/zmz125000/JXRConverter

    LocalViewer screenshot main RAW images from rawsamples.ch.

    Features

    • Webtoon gallery reader.
    • Local and network libraries for photo/video/comic/ebook.
    • Easy to use, just add your folders and done.
    • Window manager and folder tab, clean navigation flow between multiple sources.
    • Instant scanning and classification for media files in local and network folders.
    • One for all folder listing mode (Videos/Photos/Documents all with their own tags and filters).
    • Fully working on Meta Quest 3.
    • Open or share files like a file manager.
    • Fine-tuned page loader, image prefetch with no OOM crashes.
    • Gallery folder covers and reading progress.
    • Native Android app (Kotlin + Jetpack Compose).
    • Material Design 3 Navigation bar.
    • Highly optimized network image loading, with high-quality rendering.
    • HDR, Wide Color Gamut and 16-bit color mode support.
    • Image info widget (dimensions, bit depth, color space, exif).
    • Instant local archive reading with mmap.
    • ZIP/RAR/CBZ/CBR/CBT/PDF/EPUB support over network share.
    • PDF/EPUB/MOBI/FB2/TXT/AZW3/Markdown Ebook support with text formatting.
    • JXL/JXR/JPG/PNG/AVIF/HEIC HDR support.
    • 16-bit RAW formats decoding with true HDR output.
    • RAW formats support dng/cr2/cr3/nef/nrw/arw/raf/orf/rw2/pef/srw/raw.
    • Batch convert JXL/JXR/RAW to JPEG, JPEG XL, AVIF in both SDR and HDR.
    • Compatible with Oppo/OnePlus ProXDR HEIC format.
    • Compatible with Apple HDR (HEIF, AVIF).
    • Nearest, Bilinear, B-Spline, Catmull-Rom, Mitchell-Netravali, Lanczos3 image scalers using GPU shader.
    • Open offline html website archive in your browser with built-in HTTP server.
    • Network folder playback for MPV/MX Player/VLC with subtitles and external autio track.
    • Optimized Async TCP connection poll.
    • Fast smbj client with concurrent connections.
    • SMB signing JCE AESCMAC hardware acceleration.
    • Ktor OkHttp WebDAV client with HTTP/2 (default) and CIO HTTP/1.1 fallback.
    • High performance reader with network cache from EhViewer.
    • Reader double tap to open previous/next gallery.
    • Reader allow full size image decode.
    • Reader auto rotate image.
    • Reader comic dual pages mode.
    • E-Ink mode support (ported from venera-next).
    • EasyTier support (ported from moonlight-vplus).
    • TXT chapter support (ported from txtautotoc).

    Performance

    • The custom SMBJ and WebDAV clients achieve 1 Gbps network speeds over Wi-Fi 7, so after v1.11.x the image reader defaults to have image caching disabled.
    • Windows 11 JXR HDR screenshots can be displayed in fp16 hdr bitmaps, or transcode to Ultra HDR Jpeg.
    • The image loader was tweaked for preloading and decoding 100MB jpg hdr files over network without any OOM crashes, and smaller files should load instantly.
    • Accurate HDR presentation of RAW and JXR images (compared with DaVinci Resolve).

    Download

    FlavorMinimum Android VersionFeatures
    Default12Basic
    Default14 (arm64-v8a, x86-64)HDR, GPU Shaders, RAW
    EasyTier12 (arm64-v8a)Basic, EasyTier
    EasyTier14 (arm64-v8a)HDR, GPU Shaders, RAW, EasyTier

    Screenshot

    LocalViewer screenshot main page LocalViewer screenshot gallery reader LocalViewer screenshot window manager

    To use WebDAV

    openssl req -x509 -newkey rsa:4096 -keyout server.key -out server.crt -days 365 -nodes
    .\rclone.exe serve webdav "D:\" --addr :8443 --cert .\server.crt --key .\server.key --read-only --user admin --pass password

    To use SMB3 encryption:

    Get-SmbShare | Select-Object Name, EncryptData
    Set-SmbShare -Name "Media" -EncryptData $true
    Set-SmbServerConfiguration -RejectUnencryptedAccess $false -Force

    while ($true) {
        Clear-Host
        $config = Get-SmbServerConfiguration
        $sessions = Get-SmbSession
    
        Write-Host "--- SMB SERVER ENCRYPTION STATUS ---" -ForegroundColor Cyan
        Write-Host "Global Server Encryption Enabled : $($config.EncryptData)"
        Write-Host "Reject Unencrypted Access       : $($config.RejectUnencryptedAccess)"
        Write-Host "Active Sessions                 : $(($sessions).Count)"
        Write-Host "Timestamp                       : $(Get-Date -Format 'HH:mm:ss')"
        Write-Host "------------------------------------`n"
    
        if ($sessions) {
            $sessions | Select-Object ClientComputerName, ClientUserName, Dialect, NumOpens | Format-Table -AutoSize
        }
    
        Start-Sleep -Seconds 1
    }
    

    Thanks

    Here is the libraries

    App libraries

    Native codecs

    License

    Copyright 2014-2019 Hippo Seven
    Copyright 2020-2022 NekoInverter
    Copyright 2022-2023 Tarsin Norbin
    Copyright 2023-2024 Foolbar
    
    LocalViewer is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
    
    LocalViewer is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
    
    You should have received a copy of the GNU General Public License along with EhViewer. If not, see <https://www.gnu.org/licenses/>.