English · 中文 · Features · 安装 · Usage

Pick a note at random from a range you define, and open it. Try your luck!

Pick a folder, optionally layer on Obsidian search syntax, then click the sidebar icon. A slot-machine-style wheel spins up a note, with a confetti finish. Works on desktop and mobile.

Features

• Range filtering — check folders (subfolders included automatically), optionally combine with search syntax (tag: / path: / -exclude / keywords)
• Slot-machine wheel — three-stage animation: linear cruise → strong ease-out → tiny overshoot → snapback, with motion blur
• Confetti celebration — pure-canvas particle effect on settle, no third-party libraries
• Draw with / without replacement — without-replacement mode is great for drawing several distinct notes; auto-resets when the pool runs out
• Tunable parameters — scroll duration, particle count
• Command palette — Pick a random note command, bindable to a hotkey on desktop
• Bilingual UI — auto-switches between Chinese and English based on Obsidian's UI language

Install

Option A: Manual (for developers / early users)

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder in your Obsidian vault: <vault>/.obsidian/plugins/lottery/
3. Drop the three files in there
4. Obsidian → Settings → Community plugins → turn off Safe mode → enable Note Lottery

⚠️ styles.css must be shipped alongside the plugin — without it the overlay, wheel, and settings styles will break.

Option B: Community plugin marketplace (once approved)

Obsidian → Settings → Community plugins → Browse → search Note Lottery → Install

Usage

1. After enabling the plugin, a 🎰 icon appears in the left sidebar (tooltip: Pick a random note)
2. Open the plugin settings, check the folders you want to include, optionally add search syntax
3. Click the sidebar icon (or run Pick a random note from the command palette)
4. When the wheel settles, tap/click anywhere on the overlay to open the picked note (in a new tab)

Search syntax

Combinable: tag:#diary path:2024 -draft (space-separated; all conditions must match).

Contact

• Email: [email protected]
• Issues: GitHub Issues

License

MIT © 2026 tp906

中文

English · 中文

在给定的范围内，随机抽取一篇笔记打开，试试手气吧！

按文件夹和搜索语法圈定范围，点一下侧边栏图标，滚筒动画抽出一篇笔记，附带庆祝粒子。桌面和移动端均可使用。

特性

• 范围筛选：勾选文件夹（自动包含子文件夹），可选高级搜索语法（tag: / path: / -排除 / 关键词）
• 拉霸风格滚筒：匀速巡航 → 强减速 → 微过冲 → 回弹的三段动画，带 motion blur
• 粒子庆祝：定格后纯 Canvas 纸屑特效，无需第三方库
• 放回 / 不放回：不放回模式适合连续抽出不同笔记，抽完自动重置
• 可调参数：滚动时长、粒子数量
• 命令面板：随机抽取笔记 命令，桌面可绑定快捷键
• 中英双语：根据 Obsidian UI 语言自动切换（zh / en）

安装

方式一：手动安装（开发者 / 早期用户）

1. 下载 最新 Release 中的三个文件：main.js、manifest.json、styles.css
2. 在 Obsidian vault 中创建目录：<vault>/.obsidian/plugins/lottery/
3. 把三个文件放入该目录
4. Obsidian → 设置 → 第三方插件 → 关闭「安全模式」→ 启用「Note Lottery」

⚠️ styles.css 必须随插件一起分发，否则遮罩 / 滚筒 / 设置页样式将失效。

方式二：社区插件市场（提交审核通过后）

Obsidian → 设置 → 第三方插件 → 浏览 → 搜索「Note Lottery」→ 安装

使用

1. 启用插件后，左侧栏出现 🎰 图标（hover 提示「随机抽取笔记」）
2. 进入插件设置，勾选要参与抽签的文件夹，可选填搜索语法
3. 点击侧边栏图标（或命令面板执行「随机抽取笔记」）
4. 滚筒定格后，触摸 / 点击屏幕任意处打开抽中的笔记（在新标签页）

搜索语法

可组合：tag:#日记 path:2024 -草稿（空格分隔，全部条件需同时满足）

联系作者

• 邮箱：[email protected]
• 问题反馈：GitHub Issues

许可证

MIT © 2026 tp906