## File: README.md # Another Redis Desktop Manager > 🚀🚀🚀 A faster, better and more stable redis desktop manager, compatible with Linux, windows, mac. What's more, it won't crash when loading massive keys. [](LICENSE) [](https://github.com/qishibo/AnotherRedisDesktopManager/releases) [](https://github.com/qishibo/AnotherRedisDesktopManager/releases) [](https://app.fossa.com/projects/git%2Bgithub.com%2Fqishibo%2FAnotherRedisDesktopManager?ref=badge_shield) [](https://github.com/qishibo/AnotherRedisDesktopManager/) [简体中文](README.zh-CN.md) ## Windows - Download latest [exe](https://github.com/qishibo/AnotherRedisDesktopManager/releases) package from release \[or [gitee](https://gitee.com/qishibo/AnotherRedisDesktopManager/releases) in China\], double click to install. - Or by **chocolatey**: `choco install another-redis-desktop-manager` - Or by **winget**: `winget install qishibo.AnotherRedisDesktopManager` - Or **sponsor** by win store, It's not free, and I will be very grateful to you. [](https://apps.microsoft.com/store/detail/9MTD84X0JFHZ?launch=true&cid=github&mode=mini) ## Linux - Download latest [AppImage](https://github.com/qishibo/AnotherRedisDesktopManager/releases) package from release \[or [gitee](https://gitee.com/qishibo/AnotherRedisDesktopManager/releases) in China\], `chmod +x`, double click to run. - Or by **snap**: `sudo snap install another-redis-desktop-manager` **Tips**: If permission denied when selecting private key, run `sudo snap connect another-redis-desktop-manager:ssh-keys` to give access to ~/.ssh folder. [](https://snapcraft.io/another-redis-desktop-manager) ## Mac > If you can't open it after installation by brew or dmg, exec the following command then reopen:`sudo xattr -rd com.apple.quarantine /Applications/Another\ Redis\ Desktop\ Manager.app` - Download latest [dmg](https://github.com/qishibo/AnotherRedisDesktopManager/releases) package from release \[or [gitee](https://gitee.com/qishibo/AnotherRedisDesktopManager/releases) in China\], double click to install. - Or by **brew**: `brew install --cask another-redis-desktop-manager` - Or **sponsor** by app store, It's not free, and I will be very grateful to you. [](https://apps.apple.com/app/id1516451072) ## Enjoy! ## Contributors This project exists thanks to all the people who contribute. [](https://github.com/qishibo/AnotherRedisDesktopManager/graphs/contributors) [](https://opencollective.com/AnotherRedisDesktopManager) [](https://github.com/brunoksato)[](https://github.com/overtrue)[](https://github.com/wehnertb)[](https://github.com/RobinTao)[](https://github.com/hfoxy)[](https://github.com/tandavaworks)[](https://github.com/BWICompanies)[](https://github.com/dragonflydb)[](https://github.com/gauravn00b)[](https://github.com/roostinghawk)[](https://github.com/lb-xx)[](https://github.com/mikeallisonJS)[](https://github.com/Yanni8) ## Sponsor - Give me a star ⭐⭐ - Through [OpenCollective](https://opencollective.com/AnotherRedisDesktopManager) or [Github Sponsor](https://github.com/sponsors/qishibo) - If you are a Mac user, you can purchase this software from the [app store](https://apps.apple.com/app/id1516451072) to sponsor, and then let the app store automatically update it for you. [](https://apps.apple.com/app/id1516451072) - If you are a Windows user, you can purchase this software from the [win store](https://www.microsoft.com/store/apps/9MTD84X0JFHZ) to sponsor. [](https://www.microsoft.com/store/apps/9MTD84X0JFHZ) - Wechat sponsor code [Sponsor me a cup of coffee ☕] ## Feature Log - 2026-08-15: TimeSeries\Vector\ARRAY Support && Test Connection Support - 2026-07-29: Connection Group Support! - 2025-10-01: Long time no see! New features will coming soon! - 2024-11-03: Import batch commands from files - 2024-10-07: Hash field TTL support(Redis>=7.4) - 2024-06-06: Search connections support - 2024-04-10: DB custom name support - 2024-02-21: Java/Pickle viewers support - 2024-02-15: Groups/Consumers in STREAM view - 2024-01-31: Hey, long time! Command line(CLI) args support - 2023-06-22: Export\Import keys support - 2023-05-26: Search support in Stream && Slow log support - 2023-04-01: Search support in List && Deflate raw support - 2022-10-07: Arrow Keys support in key list && Memory Analysis in folder - 2022-08-05: Clone Connection && Tabs Contextmenu\Mousewheel Support - 2022-04-01: Protobuf Support && Memory Analysis - 2022-03-03: Readonly Mode && Mointor Support - 2022-01-24: Command Dump Support - 2022-01-05: Support To Load All Keys - 2022-01-01: Brotli\Gzip\Deflate Support && RedisJSON Support - 2021-11-26: JSON Editable && Subscribe Support - 2021-08-30: Execution log Support && Add Hot Keys - 2021-08-16: Custom Formatter View Support! - 2021-06-30: Sentinel Support!! - 2021-06-24: ACL Support - 2021-05-03: Stream Support && Cli Command Tips Support - 2021-02-28: Connection Color Tag && Search History Support - 2021-02-03: Multiple Select\Delete && Msgpack Viewer Support - 2020-12-30: Tree View Support!!! - 2020-11-03: Binary View Support && SSH Passparse\Timeout Support - 2020-09-04: SSH Cluster Support && Extension Commands Support - 2020-06-18: SSL/TLS Support!!! - 2020-04-28: Page Zoom && Big Key Loads With Scan && Auto Json - 2020-04-18: Unvisible Key\Value Format Support - 2020-04-04: Cluster Support!!! - 2020-03-13: Dark Mode Support!!! && JsonView In Other Place - 2020-02-16: SSH Private Key Support - 2020-02-13: Open Cli Console In Tabs - 2019-06-14: Custom Font-Family Support - 2019-05-28: Key List Resizable - 2019-05-09: Search Support In Hash List Set Zset - 2019-04-26: Auto Updater - 2019-04-09: SSH Tunnel Connection Support - 2019-04-01: Extract Search Support - 2019-02-22: Single Connection Support - 2019-01-08: Project Start ## Dev Build ### Linux Or Mac ```bash # clone code git clone https://github.com/qishibo/AnotherRedisDesktopManager.git --depth=1 cd AnotherRedisDesktopManager # install dependencies npm install # if download electron failed during installing, use this command # ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" npm install # serve with hot reload at localhost:9988 npm start # after the previous step is completed to 100%, open another tab, build up a desktop client npm run electron ``` If linux errors like this: ```bash # if error like this ../src/FontManagerLinux.cc:1:35: fatal error: fontconfig/fontconfig.h: No such file or directory # then try this sudo apt install libfontconfig1-dev ``` ### Windows ``` bash # clone code git clone https://github.com/qishibo/AnotherRedisDesktopManager.git --depth=1 cd AnotherRedisDesktopManager # install dependencies, 32-bit or 64-bit all use win32 npm install --platform=win32 # if download electron failed during installing, use this command # npm config set ELECTRON_MIRROR https://npmmirror.com/mirrors/electron/ # npm install --platform=win32 # serve with hot reload at localhost:9988 npm start # after the previous step is completed to 100%, open another tab, build up a desktop client npm run electron ``` ### Build Package ```bash # prepare before package npm run pack:prepare # build package on respective platforms # on windows build 64bit package npm run pack:win # on windows build 32bit package npm run pack:win32 # on mac npm run pack:mac # on linux npm run pack:linux ``` ## Custom Viewer > When the default viewer does not meet the needs, you can format your content via customize script. Method: Pull down the viewer list to the bottom, click "Custom -> Add", and then refer to the instructions below Note: The script needs to output formatted content through `print` `console.log` `echo` etc., which can be any string or JSON string | Config | Description | | ------ | ------ | | `Name` | Custom name | | `Command` | Executable commands, such as `xxx.py` `xxx.js` `xxx.class` etc. The file needs `x` permission, which can be executed in the form of `./xxx.py`; It can also be set to `/bin/node` `/bin/bash` or other system commands, and the script path needs to be placed in Params | | `Params` | Parameters spliced after `Command`, such as "--key `{KEY}` --value `{VALUE}`", where `{KEY}` and `{VALUE}` will be replaced with the corresponding Redis key and value. Note that if the content is invisible such as binary, you can use `{HEX}` instead of `{VALUE}`, and `{HEX}` will be replaced with the hexadecimal string. If HEX is too long (>8000 chars), it will be written to a temporary file. You can use `{HEX_FILE}` to obtain the file path, and read by yourself in the script | ### Configuration example： > Add env to the first line of the script, the final executed command is: `./home/qii/pickle_decoder.py {HEX}`, the script can receive parameters via `argv[1]`, ref [#978](https://github.com/qishibo/AnotherRedisDesktopManager/issues/987#issuecomment-1294844707) | Command | Params | | ------ | ------ | | `/home/qii/pickle_decoder.py` | `{HEX}` | | `/home/qii/shell_decoder.sh` | `{VALUE}` | ### Without execute permission `x`： > The final executed command is: `/bin/node /home/qii/node_decoder.js {HEX} --key={KEY}`, the script can receive parameters via `argv[1]` | Command | Params | | ------ | ------ | | `/bin/bash` | `/home/qii/shell_decoder.sh {VALUE}` | | `/bin/node` | `/home/qii/node_decoder.js {HEX} --key={KEY}` | ## Start From Command Line(CLI) > If you want to start from command line(CLI), you can pass args to the App. ### Examples ```bash # Linux # ./Another Redis Desktop Manager.AppImage # Mac # open /Applications/Another\ Redis\ Desktop\ Manager.app --args # Windows "D:\xxxx\Another Redis Desktop Manager.exe" # COMMON --host 127.0.0.1 --port 6379 --auth 123 --name tmp_connection # CLUSTER --cluster # SSH --ssh-host 192.168.0.110 --ssh-username root --ssh-password 123 # SENTINEL --sentinel-master-name mymaster --sentinel-node-password 123 # save connection --save # readonly mode --readonly ``` ### Parameter Description #### Common | Args | Description | Args | Description | | ------ | ------ | ------ | ------ | | --host | Redis host* | --port | Redis port| | --auth | Password | --name | Custom name| | --separator | Key separator | --readonly | Enable readonly mode| | --username | Username（Redis6 ACL）| --save| Enable saving, one-time link by default| #### SSH | Args | Description | Args | Description | | ------ | ------ | ------ | ------ | | --ssh-host | SSH host* | --ssh-port | SSH port（default:22）| | --ssh-username | Username* | --ssh-password | Password| | --ssh-private-key | Path of private key | --ssh-passphrase | Password of private key| | --ssh-timeout | SSH timeout(s) | |  | #### CLUSTER | Args | Description | | ------ | ------ | | --cluster | Enable CLUSTER mode | #### SSL | Args | Description | Args | Description | | ------ | ------ | ------ | ------ | | --ssl | Enable SSL* | --ssl-key | SSL Private Key Pem| | --ssl-ca | SSL Certificate Authority | --ssl-cert | SSL Public Key Pem| #### SENTINEL | Args | Description | | ------ | ------ | | --sentinel-master-name | Name of master group*，like 'mymaster' | | --sentinel-node-password | Password of Redis node | ## FAQ #### 1. How to connect to Redis Cluster in internal network (such as Docker, LAN, AWS)? Answer: Connect via `SSH+Cluster` (SSH to the internal network and then connecting to Cluster with internal IP such as `127.0.0.1`, `192.168.x.x`), you need to fill Redis Host with the internal IP. How to get Redis internal IP? Connect through SSH, uncheck Cluster option, and then open the console to execute `CLUSTER NODES`, select any IP in the result. #### 2. Do I need to fill in the 'Username' in the Redis configuration? Answer: The access control list (ACL) is only supported in `Redis>=6.0`, so do not fill it unless you need a special user. ## License [MIT](LICENSE) ## Support [goanother.com](https://goanother.com/)   [Download Analysis](https://qii404.me/github-release-statistics/?repo=/qishibo/AnotherRedisDesktopManager/) --- ## File: README.zh-CN.md # Another Redis Desktop Manager > 🚀🚀🚀 更快、更好、更稳定的Redis桌面(GUI)管理客户端，兼容Windows、Mac、Linux，性能出众，轻松加载海量键值 [](LICENSE) [](https://github.com/qishibo/AnotherRedisDesktopManager/releases) [](https://github.com/qishibo/AnotherRedisDesktopManager/releases) [](https://app.fossa.com/projects/git%2Bgithub.com%2Fqishibo%2FAnotherRedisDesktopManager?ref=badge_shield) [](https://github.com/qishibo/AnotherRedisDesktopManager/) ## Windows - 可以在[github](https://github.com/qishibo/AnotherRedisDesktopManager/releases) 或者 [gitee](https://gitee.com/qishibo/AnotherRedisDesktopManager/releases)下载`exe`安装包 - 或者通过**chocolatey**: `choco install another-redis-desktop-manager` - 或者通过**winget**: `winget install qishibo.AnotherRedisDesktopManager` - 或者通过Win Store**赞助**，然后让Win Store帮你自动更新版本 [](https://www.microsoft.com/store/apps/9MTD84X0JFHZ?cid=storebadge&ocid=badge) ## Linux - 可以在[github](https://github.com/qishibo/AnotherRedisDesktopManager/releases) 或者 [gitee](https://gitee.com/qishibo/AnotherRedisDesktopManager/releases)下载`AppImage`包，`chmod +x`, 双击运行 - 或者通过**snap**: `sudo snap install another-redis-desktop-manager` **Tips**: 如果选择私钥时提示权限不足，执行`sudo snap connect another-redis-desktop-manager:ssh-keys`来获取对~/.ssh文件夹的权限 [](https://snapcraft.io/another-redis-desktop-manager) ## Mac > 如果通过brew或者dmg安装后无法打开，报错**不受信任**或者**移到垃圾箱**，执行下面命令后再启动即可:`sudo xattr -rd com.apple.quarantine /Applications/Another\ Redis\ Desktop\ Manager.app` - 可以在[github](https://github.com/qishibo/AnotherRedisDesktopManager/releases) 或者 [gitee](https://gitee.com/qishibo/AnotherRedisDesktopManager/releases)下载`dmg`安装包 - 通过 **brew**: `brew install --cask another-redis-desktop-manager` - 或者通过App Store**赞助**, 然后让App Store帮你自动更新版本 [](https://apps.apple.com/app/id1516451072) ## 起飞! ## 贡献者 在这里感谢所有为此项目做出贡献的人. [](https://github.com/qishibo/AnotherRedisDesktopManager/graphs/contributors) [](https://opencollective.com/AnotherRedisDesktopManager) [](https://github.com/brunoksato)[](https://github.com/overtrue)[](https://github.com/wehnertb)[](https://github.com/RobinTao)[](https://github.com/hfoxy)[](https://github.com/tandavaworks)[](https://github.com/BWICompanies)[](https://github.com/dragonflydb)[](https://github.com/gauravn00b)[](https://github.com/roostinghawk)[](https://github.com/lb-xx)[](https://github.com/mikeallisonJS)[](https://github.com/Yanni8) ## 赞助 - 给我点个Star⭐⭐ - 通过 [OpenCollective](https://opencollective.com/AnotherRedisDesktopManager)或者[Github Sponsor](https://github.com/sponsors/qishibo) - 如果你是Mac用户, 也可以通过从[App Store](https://apps.apple.com/app/id1516451072)购买来赞助, 然后应用商店会为你自动更新 [](https://apps.apple.com/app/id1516451072) - 如果你是Windows用户，还可以通过从[Win Store](https://www.microsoft.com/store/apps/9MTD84X0JFHZ)购买来赞助，商店就会帮你自动更新 [](https://www.microsoft.com/store/apps/9MTD84X0JFHZ) - 微信赞助码 [觉得好用，赞助一些大白兔🐇奶糖!] ## 里程碑 - 2026-08-15: TimeSeries\Vector\ARRAY类型支持 && 测试链接 - 2026-07-29: 链接分组支持 - 2025-10-01: 好久不见，新功能马上归来 - 2024-11-03: 支持从文件批量导入命令并执行 - 2024-10-07: Hash键值支持TTL(Redis>=7.4) - 2024-06-06: 搜索链接支持 - 2024-04-10: DB自定义名称支持 - 2024-02-21: Java/Pickle解码视图支持 - 2024-02-15: STEAM支持查看群组和消费者 - 2024-01-31: 好久不见! 命令行参数启动支持 - 2023-06-22: 不同db\数据库之间支持导入导出key - 2023-05-26: Stream类型搜索支持 && 支持慢日志查询 - 2023-04-01: List类型搜索支持 && Deflate raw 支持 - 2022-10-07: Key列表方向键 && 内存分析支持指定文件夹 - 2022-08-05: 克隆连接 && Tabs右键和滚轮支持 - 2022-04-01: Protobuf 支持 && 内存占用分析 - 2022-03-03: 只读模式 && Mointor 支持 - 2022-01-01: Brotli\Gzip\Deflate 解压缩支持 && RedisJSON 支持 - 2021-11-26: JSON可编辑 && Subscribe支持 - 2021-08-30: 命令执行日志 && 快捷键 - 2021-08-16: 自定义文本视图 - 2021-06-30: 哨兵支持 - 2021-06-24: Redis>=6.0的ACL支持 - 2021-05-03: Stream 视图支持 && Cli命令行提示 - 2021-02-28: 链接颜色标记 && 搜索历史提示 - 2021-02-03: 多选支持 && Msgpack视图支持 - 2020-12-30: 树状列表 - 2020-11-03: Binary视图 && SSH Passparse\Timeout 支持 - 2020-09-04: SSH 集群支持 - 2020-06-18: SSL/TLS 支持 - 2020-04-28: 页面缩放 && 大键值Scan操作 && 自动Json - 2020-04-18: 不可见键值对支持 - 2020-04-04: 集群支持 - 2020-03-13: 暗黑模式 - 2020-02-16: SSH 私钥支持 - 2020-02-13: Cli新Tab打开 - 2019-06-14: 自定义字体支持 - 2019-05-28: Key列表调节宽度 - 2019-05-09: Hash List Set Zset搜索支持 - 2019-04-26: 自动更新 - 2019-04-09: SSH 通道支持 - 2019-04-01: 精确搜索 - 2019-02-22: 单链接支持 - 2019-01-08: 项目孵化 ## Dev Build > Tips: 此为开发环境，用于运行完整项目，**普通用户**直接从前面下载安装包即可 ### Linux Or Mac ```bash # clone code git clone https://github.com/qishibo/AnotherRedisDesktopManager.git --depth=1 cd AnotherRedisDesktopManager # install dependencies npm install # if download electron failed during installing, use this command # ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" npm install # serve with hot reload at localhost:9988 npm start # after the previous step is completed to 100%, open another tab, build up a desktop client npm run electron ``` If linux errors like this: ```bash # if error like this ../src/FontManagerLinux.cc:1:35: fatal error: fontconfig/fontconfig.h: No such file or directory # then try this sudo apt install libfontconfig1-dev ``` ### Windows ``` bash # clone code git clone https://github.com/qishibo/AnotherRedisDesktopManager.git --depth=1 cd AnotherRedisDesktopManager # install dependencies, 32-bit or 64-bit all use win32 npm install --platform=win32 # if download electron failed during installing, use this command # npm config set ELECTRON_MIRROR https://npmmirror.com/mirrors/electron/ # npm install --platform=win32 # serve with hot reload at localhost:9988 npm start # after the previous step is completed to 100%, open another tab, build up a desktop client npm run electron ``` ### Build Package ```bash # prepare before package npm run pack:prepare # build package on respective platforms # on windows build 64bit package npm run pack:win # on windows build 32bit package npm run pack:win32 # on mac npm run pack:mac # on linux npm run pack:linux ``` ## 自定义格式化 > 当默认可视化方式不满足需求时，可以使用自定义脚本来格式化你的内容。 方式：可视化列表下拉到底部，点击"自定义->新增"，然后参考下面说明。 注意：脚本需要通过`print` `console.log` `echo`等输出格式化好的内容，可以是任意字符串或者JSON字符串 | 配置项 | 参数说明 | | ------ | ------ | | `Name` | 自定义名称 | | `Command` | 可执行命令，如`xxx.py` `xxx.js` `xxx.class`等，该文件需要具有可执行的`x`权限，可以通过形如`./xxx.py`方式执行；也可以直接用系统命令`/bin/node` `/bin/bash`等，此时需要把脚本路径放到Params里 | | `Params` | 拼接在`Command`后的参数，如"--key `{KEY}` --value `{VALUE}`"，其中`{KEY}`和`{VALUE}`在执行时会被替换成对应的Redis key和value。注意如果内容为二进制等不可见字符时，可以使用`{HEX}`，`{HEX}`会被替换成对应value的16进制即hex编码。如果HEX过长(>8000字符)时会被写入到临时文件，可以用`{HEX_FILE}`获取文件路径，脚本中自行读取即可 | ### 配置样例： > 脚本文件首行一般要增加env说明，最终执行的命令如: `./home/qii/pickle_decoder.py {HEX}`, 脚本中可以使用`argv[1]`接收参数，参考 [#978](https://github.com/qishibo/AnotherRedisDesktopManager/issues/987#issuecomment-1294844707) | Command | Params | | ------ | ------ | | `/home/qii/pickle_decoder.py` | `{HEX}` | | `/home/qii/shell_decoder.sh` | `{VALUE}` | ### 脚本文件无执行权限时： > 最终执行的命令如: `/bin/node /home/qii/node_decoder.js {HEX}`, 脚本中可以使用`argv[1]`接收参数 | Command | Params | | ------ | ------ | | `/bin/bash` | `/home/qii/shell_decoder.sh {VALUE}` | | `/bin/node` | `/home/qii/node_decoder.js {HEX} --key={KEY}` | ## 命令行启动 > 如果你有需求从命令行启动程序，可以通过如下方式，自定义不同的连接参数。 ### 示例 ```bash # Linux # ./Another Redis Desktop Manager.AppImage # Mac # open /Applications/Another\ Redis\ Desktop\ Manager.app --args # Windows "D:\xxxx\Another Redis Desktop Manager.exe" # COMMON --host 127.0.0.1 --port 6379 --auth 123 --name tmp_connection # CLUSTER --cluster # SSH --ssh-host 192.168.0.110 --ssh-username root --ssh-password 123 # SENTINEL --sentinel-master-name mymaster --sentinel-node-password 123 # save connection --save # readonly mode --readonly ``` ### 参数说明 #### 通用 | 参数 | 说明 | 参数 | 说明 | | ------ | ------ | ------ | ------ | | --host | 地址* | --port | 端口| | --auth | 密码 | --name | 自定义名称| | --separator | 分隔符 | --readonly | 开启只读模式| | --username | 用户名（Redis6 ACL）| --save| 保存连接（默认不保存）| #### SSH | 参数 | 说明 | 参数 | 说明 | | ------ | ------ | ------ | ------ | | --ssh-host | 地址* | --ssh-port | 端口（默认22）| | --ssh-username | 用户名* | --ssh-password | 密码| | --ssh-private-key | 私钥路径 | --ssh-passphrase | 私钥密码| | --ssh-timeout | 超时（秒） | |  | #### CLUSTER | 参数 | 说明 | | ------ | ------ | | --cluster | 开启集群模式 | #### SSL | 参数 | 说明 | 参数 | 说明 | | ------ | ------ | ------ | ------ | | --ssl | 开启SSL模式* | --ssl-key | SSL私钥路径| | --ssl-ca | SSL证书机构 | --ssl-cert | SSL公钥路径| #### SENTINEL | 参数 | 说明 | | ------ | ------ | | --sentinel-master-name | Master组名称*，如mymaster | | --sentinel-node-password | Redis节点密码 | ## FAQ #### 1. 内网中的Redis集群如何连接（如Docker内，局域网内，AWS内）？ 答：使用`SSH+Cluster`的方式连接（等价于先SSH到内网，再使用内网ip连接Cluster），Redis的Host填写Redis**内网ip**地址如`127.0.0.1` `192.168.x.x`。 Redis内网地址如何获得？直接以SSH的方式连接，不勾选Cluster，然后打开命令行，直接执行`CLUSTER NODES`， 在结果中选一ip即可。 #### 2. Redis配置中的`Username`用户名是否需要填写？ 答：用户名为`Redis>=6.0`才支持的访问控制列表（`ACL`），默认不需要填写（为default），指定特殊用户时才填写。 ## License [MIT](LICENSE) ## Support [goanother.com](https://goanother.com/)   [Download Analysis](https://qii404.me/github-release-statistics/?repo=/qishibo/AnotherRedisDesktopManager/)