Note Lottery

approved

by wang

Randomly pick and open a note from your filtered range — a slot-machine-style wheel with celebration confetti. 在你设定的文件夹与搜索范围内随机抽取一篇笔记打开，拉霸风格滚筒动画 + 庆祝粒子，试试手气吧！ - This plugin has not been manually reviewed by Obsidian staff.

↓ 52 downloadsUpdated 1mo agoMIT
Install in ObsidianView on GitHub

🎰 Note Lottery / 笔记抽签

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

SyntaxMeaning
keywordNote name or path contains this word
tag:#diaryHas this tag (includes frontmatter tags)
path:2024Path contains 2024
-draftExclude notes containing "draft"

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

Contact

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:#日记含此标签（含 frontmatter 中的 tags）
path:2024路径含 2024
-草稿排除含「草稿」的笔记

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

联系作者

许可证

MIT © 2026 tp906

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.