Skip to content

WooHooDai/PaperlikeMenu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PaperlikeMenu Icon

PaperlikeMenu

简体中文 / English

Introduction

A full-featured Dasung Paperlike display control utility for macOS.

Powering capabilities that the official client lacks:

  • ∞ Custom Composite Commands & Unlimited Hotkeys
  • 👋 Native multi-touch gesture support for macOS.
  • 👁️ Built-in Anti-Dithering
  • ··· And More: Auto-refresh, always-on menu bar, and more.

支持简体中文和英语,中文用户请查阅这份介绍

全功能的大上(Dasung) Paperlike 系列墨水屏控制工具,专为 macOS 打造。

官方没有的能力, PaperlikeMenu 为你提供:

  • ∞ 自定义组合命令&无限全局快捷键;
  • 👋 触屏操控
  • 👁️ 内置禁止画面抖动
  • ··· 更多:菜单栏常驻、自动刷新、……

Download Now

👀 Screenshots

Main Interface

Main Interface

Hotkey Settings

Hotkey Settings

⏬ Download & Install

  1. Go to the latest release page and download PaperlikeMenu.dmg
  2. Open PaperlikeMenu.dmg
  3. Drag PaperlikeMenu.app to the Applications folder
  4. Launch PaperlikeMenu from Applications

For installation troubleshooting (first-launch blocking, "app is damaged", upgrade/uninstall), see: docs/install_en.md

⚙️ Features

🧾 Feature List

Feature Description
🤖 Custom Commands Combine multiple instructions into one command
💪 Full Control Control display mode, contrast, ink level, front light, brightness, and color temperature
⚡️ Hotkeys Assign global hotkeys to any command
🌟 Quick Actions Pin any command to the main interface
👋 Touch Support Bring touch gestures to macOS for Paperlike
♻️ Auto Refresh Supports refresh intervals as low as 3 seconds, with countdown timer ⏳
👁️ Anti-Dithering Built-in anti-dithering for E-ink displays
🔝 Menu Bar App Always available in the menu bar for quick access
👍 Preset Commands Built-in practical presets out of the box
··· Other Settings Launch at login, show/hide Dock icon

🆚 Comparison with Official Client

Feature PaperlikeMenu Official Client
Custom Commands
Full Control
Hotkeys Unlimited 4
Quick Actions
Touch Support
Menu Bar App
Anti-Dithering
Auto Refresh Interval ≥3s ≥30s

📖 Usage Guide

🌍 Requirements

  • OS: macOS 14.0+
  • Permission: Touch Service requires Accessibility permission
  • Hardware: Dasung Paperlike display connected via USB
  • This project has currently been validated only on the following setup, and does not guarantee compatibility with all devices, OS versions, or scenarios:
    • Display: Dasung PaperLike HD-FT M
    • Computer: Mac mini M4

♻️ Auto Refresh

  • Auto refresh interval is configurable, with a minimum of 3 seconds (>= 3s).
  • If you change the interval while auto refresh is running, the new interval takes effect after the current refresh cycle finishes.
  • If you want the new interval to apply immediately, trigger a manual refresh once.

👁️ Anti-Dithering

  • Enabling anti-dithering is recommended.
  • It helps suppress temporary E-ink dithering, reduce flicker, and ease visual fatigue.

👋 Touch Service

Permission (Accessibility)

Touch Service depends on macOS Accessibility permission. If not granted yet, follow these steps:

  1. Click the "Touch Service" button in the main interface. The app will trigger the permission request.
  2. Go to "System Settings -> Privacy & Security -> Accessibility", find PaperlikeMenu, and grant permission.
  3. Return to the app and click "Touch Service" again.
  4. If touch still does not work, remove PaperlikeMenu from the Accessibility list, turn off "Touch Service", and repeat steps 1-3.

Supported Gestures

Gesture Action
Single-finger tap Left click
Single-finger double tap Double left click
Single-finger long press and move Left-button drag
Two-finger long press Right click
Two-finger scroll Page scrolling
Three-finger pinch in / out Page zoom

🤖 Commands, Hotkeys, Quick Actions

Hotkey Panel

  1. Open path: Settings -> Hotkeys
  2. Each row is one command. Each command can bind one global hotkey. If "Quick Action" is checked, the command appears on the main interface.
  3. Use the "Enable" toggle to enable or disable a command.
  4. Drag selected rows to reorder Quick Actions on the main interface.
  5. Hold cmd / shift and click to multi-select commands, then delete in batch.
  6. Use cmd+z or the "Undo" button to undo deletions.
  7. Use the "Reset" button to restore default commands.

Command Reference

  • Single-command example: refresh 1
  • Combined-command example: mode text -- contrast 5 -- ink 2 -- refresh 2
  • Full command list and examples: docs/command_en.md

Support This Project

If this project helps you, your support is appreciated.

A GitHub Star is always welcome 🌟

For questions or suggestions, please open an issue or email me at (woohoodai@gmail.com).

Buy Me A Coffee



Disclaimer

  1. This is a third-party project and is not affiliated with, endorsed by, or officially authorized by Dasung.
  2. This project is licensed under Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0).
  • You may share and redistribute under the license terms
  • Attribution must be retained
  • Commercial use is not allowed
  • Modified derivative versions may not be distributed

About

A macOS menu bar controller for Dasung Paperlike e-ink displays with full tuning, touch support, customizable hotkeys/actions, auto refresh, and support for disabling system dithering. | 大上 Paperlike 系列墨水屏 macOS 菜单栏控制应用:完整参数调节、触屏手势、自定义快捷键与快捷动作、自动刷新、支持关闭系统抖动(Dithering)。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors