Hymns

by viacai
5
4
3
2
1
Score: 50/100

Description

在Obsidian中浏览、搜索、播放诗歌:只支持大本诗歌 、 补充诗歌、 青年诗歌等

Reviews

No reviews yet.

Stats

1
stars
270
downloads
0
forks
35
days
3
days
3
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
34
commits

Latest Version

4 days ago

Changelog

更新日志 / Changelog


[2.7.1] - 2026-11-16

本次更新

  • 滑动方向调回熟悉的顺序:投影里从右往左滑=下一首,从左往右滑=上一首;鼠标横拖也一样,键盘 ← → 不变。
  • 从侧边栏点歌,翻歌就按那份列表来:最近打开按历史顺序、播放列表按歌单顺序、诗歌列表(如大本)按该列表顺序、搜索结果按搜索顺序。从「最近打开」点进来只是回看,不会改写最近打开记录。

修复

  • 点过按钮后,长按确定键又能打开诗歌选择界面了:以前点完按钮再按确定键会变成再按那颗按钮;现在短按仍是聚焦搜索框,长按仍是打开诗歌选择界面。

小提示

  • 与经文投影互切建议搭配「Bible Search and Reader」5.2.0 或更新版,两个插件一起更新最省心。

[2.7.0] - 2026-11-15

本次更新

  • 诗歌选择面板:投影里长按顶部搜索框(或长按确定键)打开「诗歌选择」——左边选诗歌分类,右边按首数分组(0=1–99、1=100–199 …… S=附录),再点分组看该组诗歌。左栏对齐搜索框左侧;↑ ↓ 选择、→ 确认并投出这一首、← 逐级返回;关掉再开仍停在原处,重启 Obsidian 才回默认。
  • 点选会高亮:投影播放列表、侧边栏「最近打开」和播放列表里点过的那首,再回来看都会标出来,方便接着看下一首。
  • 回看不打乱顺序:在「最近打开 / 历史」里点一首只是回看,不会把它顶到最上、也不刷新面板位置;只有在搜索、列表或别处播放它时才会更新顺序与位置。

修复

  • 上一首 / 下一首各走各的:从搜索结果点进的,← → 只在这批搜索结果里翻;从播放列表 / 诗歌选择面板点进的,只在该列表里翻。方向上:历史记录从上往下是上一首,搜索结果、播放列表、诗歌列表从上往下是下一首;左右滑动同样对应「上一首 / 下一首」。
  • 点顶部搜索框会把打开中的诗歌选择面板收起、候选正常弹出;选择面板里按确定键不再误触发。

小提示

  • 与经文投影互切建议搭配「Bible Search and Reader」5.2.0 或更新版,两个插件一起更新最省心。
  • 投影里 ↑ ↓ 翻节、← → 换诗歌、空格播放、Esc 退出,都和以前一样。

[2.6.0] - 2026-11-14

本次更新

  • 投影里能翻「最近打开」和播放列表了:工具条在播放 ▶ 与 ⛶ 之间多了两个按钮,两级查看——先选列表,再点诗歌;面板支持鼠标滚轮、↑ ↓ / PageUp / PageDown / Home / End,按 Enter 直接投这一首并把焦点还给投影,Esc 先收面板。
  • 「上一首 / 下一首」按你看到的顺序走:与「最近打开」面板同序,空白首页按上一首就是最近打开的第一首,再按依次往下;下一首回到上方,走到两端给提示、不循环。投影里打开过的诗歌会记进插件数据,重启 Obsidian 后仍在,默认保留 50 首(设置里可改 1–200)。
  • P 恒窗口、O 恒全屏:无论当前是经文投影还是诗歌投影、无论是否已经整屏,按下去都得到确定的模式;Q / W / E 切到经文投影时保留当前的全屏 / 窗口状态。

修复

  • 连续切换投影不再「第二次变窗口」:修掉整屏图层交接时与浏览器全屏异步队列抢时序的问题,诗歌全屏 ↔ 经文全屏来回切多次都稳定;从整屏经文投影按 P 过来也会真正退出旧层的整屏。
  • 历史面板按 Enter 选歌后焦点残留、按钮置灰与边界提示一并修好;移动端安全区、卸载清理继续加固。

小提示

  • 与经文投影互切建议搭配「Bible Search and Reader」5.2.0 或更新版,两个插件一起更新最省心。
  • 投影里 ↑ ↓ 翻节、← → 按「最近打开」翻上一首 / 下一首、空格播放、Esc 退出保持不变。

[2.5.0] - 2026-11-13

本次更新

  • 投影左上角多了模式按钮:点开就能选「诗歌全屏 / 诗歌窗口」,或切到经文的逐节 / 并列 / 混合投影;点当前模式只是收起菜单,不会关掉投影。
  • 顶部清爽了:去掉原来那条把手行,模式按钮和搜索框同一行,搜索框紧挨右侧五个按钮;屏幕窄时自动排成两行,不挤不裁切。
  • 拖顶栏=拖整个 Obsidian 窗口(桌面端);手机上不会再出现「只把投影图层拖走」的情况。
  • 插件一启用,侧边栏就有诗歌面板:不用再点功能区图标,设置里可以关掉,也不会顶掉 Bible 的面板。

修复

  • 禁用插件终于真的关掉了:以前禁用后只剩没样式的空壳,必须重启 Obsidian 才能重新启用;现在「禁用 → 立即重新启用」都正常。
  • 手机投影顶部不再被状态栏 / 灵动岛挡住。
  • Esc 更稳:来回切换投影模式后不再偶尔失灵;菜单开着按 Esc 先收菜单。
  • 没装 Bible Search and Reader 时,菜单里的经文项会置灰并在投影内说明原因,提示不会被全屏盖住。

小提示

  • 与经文投影互切建议搭配「Bible Search and Reader」5.1.0 或更新版,两个插件一起更新最省心。
  • 投影里 ↑ ↓ 翻节、← → 翻本次投过的诗歌、空格播放、Esc 退出,都和以前一样。

[2.4.0] - 2026-11-12

本次更新

  • 不用先打开诗歌面板了:Obsidian 一启动就能直接按 O / P 开投影、按 [ 切到诗歌标签页。
  • [ 改成开关:按一下切到诗歌标签页,再按一下关掉;切回来时正在看的诗歌和搜索内容都保留。
  • 投影里 ← → 只翻「这次投过的诗歌」:不会跳到没看过的诗歌,重启 Obsidian 自动清空。焦点不在搜索框时按 Enter 就能直接搜歌。
  • 和经文投影来回切不丢进度:从诗歌投影切去经文投影、再按 O / P 回来,原来那首诗歌连第几节都还在。

小提示

  • 与经文投影互切需搭配「Bible Search and Reader」5.0.1 或更新版,建议两个插件一起更新。
  • 投影里 ↑ ↓ 翻节、空格播放、Esc 退出,都和以前一样。

[2.3.0] - 2026-11-11

本次更新

  • 右上角一个按钮,三种打开方式:点一下就能选「窗口投影 / 全屏投影 / 新标签页打开」。
  • 四个快捷键,不点按钮也能用(在输入框里打字时不会误触发):
    • O 全屏投影、P 窗口投影;再按一次就关掉,两个键互相按还能在两种投影间切换。
    • [ 新标签页打开诗歌首页;] 用系统自带的 PDF 阅读器打开当前这首的 PDF,和预览工具栏那个「在新标签打开 PDF」按钮一样。
  • 不会越开越多:首页标签页、PDF 标签页各最多一个,换一首诗歌会换成新内容,不会一直新建标签页。
  • 没预览诗歌也能开投影:画面上会有醒目的提示卡,照着在上方搜索框选一首、或按 ← → 挑一首就能投;新标签页则停在诗歌首页。

修复

  • 退回诗歌列表后再开投影,不会再冒出上一首预览过的诗歌。

小提示:投影里 ↑ ↓ 翻页、← → 换诗歌、空格播放、Esc 退出,都和以前一样。


[2.2.1] - 2026-11-09

修复

  • 预览诗歌 PDF 变清晰了,拉宽侧边栏也不会越拉越糊 以前在插件里预览诗歌 PDF,字看起来比直接用系统打开同一个文件要虚;把侧边栏拉宽时,画面像被硬拉大,反而更模糊。现在会按屏幕的实际清晰度来绘制,高分屏上一样清楚;侧边栏拉宽、从浮动改成固定、手机转横屏之后,也会按新的宽度重新画清楚。 重新画的时候不会清空页面,也不会跳回第一页,原来翻到第几页还停在第几页。拖动侧边栏的过程中为了不卡顿,会等手停下约半秒再变清晰。

小提示:预览里没有单独的放大按钮,字号会跟着侧边栏宽度变;想放大细看,可以点「在新标签页打开 PDF」,用系统自带的阅读器看。


[2.2.0] - 2026-11-08

本次更新

  • 新增「白板诗歌」:只看这一首,也只分享这一首 白板诗歌是几百首合在一起的一本大 PDF,以前想看其中一首得整本翻。现在预览诗歌 PDF 时:

    • 怎么打开:按 B 键,或者点「更多 → 查看白板PDF」,标签页里就只出现这一首的白板页面;一首占好几页的会一起带出来,不会夹带整本书。
    • 怎么分享:点「分享白板PDF」,发出去的也只是这一首的页面,不会把整本大文件发给别人。
    • 白板合订本放在仓库里任何文件夹都能自动认出来,设置里不用填路径;如果同一本有好几份,也会自动挑合适的那本。
    • 设置里能看到认出了几本:哪几本找到了、放在哪、每本认出了多少首,都列得清清楚楚;旁边有「浏览…」「自动检测」「清空」,还有「重新检测」「读取全部书签」。
    • 查看 / 分享时生成的那些小 PDF 只是缓存,放在合订本旁边的「单页」文件夹里,设置里点「清空单页白板PDF」可以一键清掉(进回收站,能恢复),原来的大文件不会动。
  • 投影时也能直接搜诗歌换歌 投影画面顶部多了一个搜索框,输入编号、歌名或歌词,下面会列出所有匹配的诗歌,每条都带歌名和含关键词标出的那句歌词;点一条就立刻切过去投。框里有字时会出现清空按钮,一下就能全清。 选完一首再点一下搜索框,上次的候选会原样弹回来,顺序、位置都不变,还会把上次选中的那首标出来,方便连着投一批。 小提示:搜出来的这一批会接着成为「← → 换诗歌」的顺序;在搜索框里打字时,空格、方向键、P、O 这些快捷键会先让给输入框。

  • 搜索词开头加字母,可以临时搜别的诗歌本 不管当前选的是「大本诗歌」还是别的诗歌本,只要在搜索词最前面加字母,就能临时指定搜哪几本:A 全部、D 大本、B 补充本、C 唱诗人、X 新歌颂咏、E 儿童、Q 青年、T 特会、O 其他。字母可以连着写,比如「DB恩典」就是同时在大本和补充本里找「恩典」;只写「DB」就列出这两本的全部诗歌。标出来的只会是真正的关键词「恩典」,不会把开头的字母算进去。投影里的搜索框也用同一套规则。 另外,按住底部那颗分类按钮约半秒,不管现在选的是哪一本,都能马上回到「全部诗歌」;轻点一下还是照旧弹分类菜单。

  • 投影的按钮和手势重新整理了

    • 屏幕左右两侧的大按钮改成「上一节 / 下一节」,箭头也换成 ↑ / ↓,不会再看错成换歌;右上角那两个改成「上一首 / 下一首」。
    • 键盘不变:↑ ↓ 翻节、← → 换诗歌。
    • 触屏和鼠标拖拽现在完全一致:左右拖 / 滑换诗歌(左=下一首,右=上一首),上下拖 / 滑翻节(下=上一节,上=下一节);鼠标滚轮还是翻节。

修复

  • 投影顶部不会再只剩下关闭按钮掉到第二行 现在够宽时整排一行;真放不下时会整整齐齐变成两行(第一行搜索框、第二行按钮一排),不会再单独把 ✕ 挤下去,也不会把搜索框压得太窄不好输入。

小提示:这里说的「一节」就是投影里的一页 PDF;Home / End 跳到第一页 / 最后一页,空格播放,O 全屏,P / Esc 退出,都和以前一样。


[2.1.0] - 2026-11-08

本次更新

  • 投影时的方向键改成:上下翻页、左右换诗歌 以前把诗歌投到大屏时,左右键是翻页,想换上一首 / 下一首没有快捷键。现在按 ↑ / ↓ 是上一页 / 下一页,按 ← / → 是上一首 / 下一首(PageUp / PageDown 和上下键一样)。换诗歌会跟着你当前正在浏览的那份列表走,会自动跳过没有 PDF 的诗歌,到头会提示一下;如果正在放伴奏,也会跟着换成新这首,不会出现画面换了、声音还是上一首。
  • 投影画面上的按钮也一起调整了 屏幕左右两侧的大箭头现在改成「上一首 / 下一首」(触屏点起来也顺手),右上角多了 ↑ ↓ 两个小按钮用来翻页。底部那行操作提示也改成了新规则。

小提示:触屏左右滑动和鼠标滚轮仍然是翻页,没有改动;Home / End 还是跳到第一页 / 最后一页,空格播放,O 全屏,P / Esc 退出。


[2.0.4] - 2026-10-30

本次更新

  • 双列的左右两列之间加了一条分割线 窗口够宽、标签页分成两列时,两列中间现在有一条细细的竖线,一眼就能分清哪边是列表 / 预览、哪边是搜索和播放。这条线只是画上去的,不会占地方、也不会把哪一边挤窄。窄屏变回单列时它会自动消失。

修复

  • 修好了切换诗歌时右列宽度会抖一下的问题 以前在双列模式下切换诗歌,右边的搜索、播放那一列宽度会闪动变化一下。原因是左列的宽度会跟着内容变(切歌后内容长度不同),从而把右列挤得宽一下窄一下。现在右列宽度固定,不再受内容影响,切换时稳稳的。

[2.0.3] - 2026-10-30

本次更新

  • 检查到新版本时可以直接一键更新了 以前在设置里点「立即检查更新」,只会告诉你“有新版本”,却没法直接更新,只能自己去下载。现在发现有新版本时,弹出来的更新说明窗口右下角会有一个「立即更新到 vX」按钮,点一下就自动下载安装,装完提示重启 Obsidian 即可。 启动时右上角那条“有可用更新”的通知,点开后同样可以一键更新。

[2.0.2] - 2026-10-30

修复

  • 手机横屏也能用双列了 以前手机横屏时窗口还是不够宽,标签页只能单列。现在只要手机是横着的,标签页就会自动变成双列(左边列表 / 预览,右边搜索、播放)。
  • 预览诗歌时,侧边栏收起再划出、浮动和固定之间切换,不再闪一下、也不会跳回第一页 以前正在预览一首诗歌的 PDF 时,只要把侧边栏收起来再划出来(手机、电脑都一样),或者把侧边栏在浮动、固定之间切换,画面会闪一下,并且 PDF 会跑回第一页,要重新翻到刚才那页。现在这些操作都会稳稳停在你刚才看的那一页,画面也不再闪动。

小提示:预览位置是按诗歌记住的——每首诗歌各自记住自己上次看到的地方,换一首再回来也能接上。


[2.0.1] - 2026-10-29

修复

  • 修好了手机上「浮动侧边栏打开后一片空白」的问题 在手机上,如果侧边栏没有固定在屏幕上(是浮动的、用手划出来那种),有时打开后里面是空的、看不到任何诗歌。有两种情形都会触发:
    • 点侧边栏右上角的「在新标签页打开」之后
    • 把侧边栏划掉、再划出来之后 现在这两种情况都会正常显示诗歌列表,不会再变成空白。

[2.0.0] - 2026-10-29

本次更新

  • 插件可以「在新标签页打开」了 标题栏最右边多了一个按钮,点一下就能把诗歌面板在独立标签页里打开,方便在手机横屏、或者想一边看列表一边看预览时使用。标签页里不会出现这个按钮(避免自己开自己)。
  • 标签页会按宽度自动单列 / 双列 窗口够宽(如电脑、手机横屏)时自动变成双列:左边是列表 / 预览,右边是搜索、预览按钮、播放;窗口变窄(如手机竖屏、拉窄的侧边栏)时自动变回单列。现在手机横屏也能用双列了。
  • 双列右侧的布局固定了顺序 最上面是「最近打开 / 播放列表」,中间是搜索框(或在预览时变成预览按钮),最下面是 MP3 播放栏(始终固定在底部,不会乱跑)。
  • 搜索框里有了「清空」按钮 搜索框里有字时,右边会出现一个 ×,点一下就把字全清掉,不用一个一个删。
  • 歌单里预览更顺手了 在歌单里点诗歌进入预览后,左右翻页只在这一张歌单里切换;点「播放」会把整张歌单加进当前播放列表。

修复

  • 修好了「重开 Obsidian 后标签页用不了」的问题 以前重开 Obsidian,标签页有时会一直显示「没扫描到诗歌」、点不动,要关掉重开才行。现在所有面板都会正常刷新,打开即用。
  • 修好了标签页里「最近打开 / 播放列表」内容多了看不到的问题 以前这一块内容一多就被截断,也没有滑条。现在和侧边栏一样,会预留滑条、可以滚动查看全部。
  • 「最近打开 / 播放列表」不再越堆越多 以前每次刷新都会多复制一份、越积越高,现在做了去重。
  • 预览过的诗歌会正确记进「最近打开」了 以前像 D009 这样预览过的诗歌,在「最近打开」里找不到,记账不准;现在预览就会记进去。
  • 去掉了「最近打开 / 播放列表」外面多出来的一层方框 以前这块外面套了两层框,看起来重重的,现在只保留里面各自的边框。
  • 修好了「最近打开 / 播放列表」有时点不动的问题 以前在右侧这一块,有时点「最近打开」或「播放列表」没反应、有时又有反应。原因是左侧列表每次刷新都会把这一块重建一遍,刷新刚好撞上你点击的瞬间,这次点击就被丢掉了。现在这一块建好就稳定保留、原地刷新,不再被重建,点一下就能稳定展开 / 收起。

[1.0.8] - 2026-10-28

本次更新

  • 可以把诗歌文件分享给其它软件了 在诗歌右边的「⋯」菜单里,新加了分享相关的一项:
    • 手机(安卓、苹果都支持):点「分享 PDF」或「分享 MP3」,会弹出手机的分享面板,直接选微信、QQ 就能发出去
    • 电脑:点「复制 PDF 文件」或「复制 MP3 文件」,文件就复制好了,再到微信、QQ 里按 Ctrl+V(苹果电脑按 ⌘V)粘贴即可,和你平时在文件夹里复制文件一模一样
    • 万一哪台电脑复制不了,插件会自动打开这个文件所在的文件夹,按 Ctrl+C 就能复制;文件的完整位置也会一并帮你复制好
  • 侧边栏的「播放列表」,点一下是看内容了 以前点某个歌单,会直接把整单播放起来;现在点一下是展开,能看到这个歌单里包含了哪几首诗歌。想整单播放的话,点那一行右边的 ▶ 按钮就行。
  • 歌单明细里,点歌名就能预览 在点开某个歌单后的明细弹窗里,点某一首诗歌的名字,就能在侧边栏直接打开这首的 PDF 来看。

修复

  • 修好了电脑上「复制文件」复制不了的问题 以前在 Windows 电脑上点了复制,会提示「已复制」,但到微信里粘贴却什么都没有。现在换成了系统标准的复制方式,能正常粘出文件了。

[1.0.7] - 2026-10-22

修复

  • 侧边栏变窄时,下面的按钮不会再被挡住了 在侧边栏里预览诗歌、或者播放诗歌时,如果侧边栏拉得很窄,下面那一排按钮(比如「更多」「关闭」「查看PDF」「播放列表」等)以前会被挤到外面、点不到。现在按钮会自动换行,无论侧边栏多窄,所有按钮都看得清、点得到。

[1.0.6] - 2026-10-21

本次更新

  • 新增「窗口投影」,方便投屏大家一起唱
    • 怎么打开:在诗歌右边的「⋯」菜单里点「窗口投影」;或者侧边栏预览时直接按 P
    • 翻页:点屏幕左右两边的箭头,也可以用方向键、鼠标滚轮,触屏左右滑动
    • 放伴奏:点右上角 ▶ 或按空格键,底部会出现播放条,可以暂停、拖进度;播放条会自己让开位置,不会挡住歌词
    • 放大到整屏:按 O 键(或点全屏按钮)打开全屏投影;全屏里按 O 或 Esc 直接退出投影
    • 退出:按 Esc,或点右上角 ✕
    • 画面不会变形:一屏只显示一页,多余的地方留黑边,字永远不会被裁掉
    • 默认只占满 Obsidian 窗口,按住顶部那条可以拖动投影位置(双击回到原位)
  • 儿童诗歌、新歌颂咏现在也能看到歌名了 以前这类诗歌的文件名只有一个编号(比如 E001),歌名只印在 PDF 里面,列表里就只剩一个光秃秃的编号。现在插件会把歌名读出来,显示成「E001 神说要有光」,直接搜歌名也能找到它。

修复

  • 修好了附录诗歌「放错歌」的问题 有些附录诗歌(比如 Ds1、Q附1)以前点播放放的是别的歌,有的干脆没声音。现在每首都能对上自己的伴奏了。一共修好了 22 首,另外 11 首以前没声音的诗歌现在也能放了。
  • 全屏投影退出更跟手了 全屏投影里按 Esc 或 O 退出时,以前会顿一下才消失,现在能干脆利落地关掉,和窗口投影一样顺滑。

小提示

  • 特会诗歌大多是扫描件(相当于一张图片),里面没有文字,读不出歌名,暂时还是显示分类名。

[1.0.4] - 2026-10-18

本次更新

  • 修好了「搜索结果看着不全」的问题 以前搜一个词,结果被拆散在好几页里,只能看到当前页那几条。现在一次列出全部结果,顶部还会告诉你「命中 N 首」。
  • 输入「的」「我」这种太常见的字时,最多显示 500 首,以免卡顿。

[1.0.3] - 2026-10-16

本次更新

  • 搜索结果里长按一首诗歌,可以直接跳到它在分类里的位置,看完点「返回」还能回到搜索结果
  • 侧边栏预览 PDF 时,左右滑动就能切到上一首 / 下一首
  • 跳转过去的那首诗歌会高亮一下,一眼就能找到
  • 仓库里缺 PDF 或缺 MP3 时,会提醒你到 QQ 群(1128049033)下载,缺什么就提示什么

[1.0.2] - 2026-10-16

本次更新

  • 修好了「检查更新失败」的问题,现在每次打开 Obsidian 都会自动检查一次新版本,有新版本就在右上角提醒你
  • 更新完成后会自动清理旧版本的备份文件,不留垃圾

[1.0.1] - 2026-10-16

本次更新

  • 修好了只装三个文件时「无法预览 PDF、无法建立歌词索引」的问题,现在装上就能用,不需要额外文件
  • 插件已通过 Obsidian 官方审核

[1.0.0] - 2026-10-16

首次发布

  • 可以按编号(如 D116)或关键词(如 恩典 耶稣)搜索诗歌,侧边栏预览 PDF,播放 MP3,收藏和建歌单
  • 自带 7 个主题歌单,不会覆盖你自己的歌单
  • 每次打开 Obsidian 自动检查更新

README file from

Github

Hymns(诗歌)Obsidian 插件

诗歌浏览、搜索、播放与收藏插件:按编号(如 D116)或关键词(空格分隔,如 恩典 耶稣)实时搜索,预览 PDF,播放 MP3,收藏与播放列表。桌面端与移动端通用。仅支持大本诗歌 / 补充诗歌 / 唱诗人 / 新歌颂咏 / 儿童诗歌 / 青年诗歌 / 特会诗歌

注意:插件本体约 1.5 MB,由于诗歌PDF(约 535 MB)与 MP3(约 3.79 GB)体积较大,请到 QQ 群 1128049033 另行下载,解压到你 Obsidian 仓库的任意位置。obsidian启动时,插件会自动扫描仓库中的诗歌PDF与MP3,并自动创建诗歌索引和歌词索引。

功能

  • 启用即在侧边栏:插件一开启就自动生成诗歌面板,不用再点功能区图标;设置里可以关掉,也不会顶掉 Bible 的面板。
  • 实时搜索:按编号或关键词即时过滤,分组展示(大本诗歌 / 补充诗歌 / 唱诗人 / 新歌颂咏 / 儿童诗歌 / 青年诗歌 / 特会诗歌 / 其他)。
  • PDF 预览:单击诗歌在侧边栏查看;双击诗歌、预览时按 ],或点预览工具栏的「在新标签打开 PDF」,都会用系统自带的 PDF 阅读器在新标签页打开。
  • 右上角按钮,三种打开方式:点一下会列出「窗口投影 / 全屏投影 / 标签页面板」。按 [ 是诗歌标签页的开关:按一下切过去、再按一下关掉;切回来时正在看的诗歌和搜索内容都保留(最多只开一个,不用先打开侧边栏)。
    • 窗口够宽时自动变双列:左列放诗歌列表 / 搜索结果 / PDF 预览;右列自上而下是「最近打开 / 播放列表」→ 搜索栏或预览按钮(看当前是浏览还是预览)→ MP3 播放。
    • 窗口变窄自动回到单列,与侧边栏的界面完全一致。拖动窗口大小、手机横竖屏切换都会实时变化(手机横屏一般就是双列,竖屏是单列)。
  • MP3 播放:一键播放诗歌音频,支持顺序 / 单曲循环 / 列表循环;可切换音频来源。
  • 收藏与播放列表:收藏诗歌;内置 7 个主题歌单(倪柝声 / 李常受 / 余洁麟 / 和受恩 / 霍华德 / 以撒·华滋 / 约翰·牛顿),也可自建歌单。
  • 联动:可在底部播放栏「联动」里勾选 MP3 随 PDF 切换以及 PDF 随 MP3 切换。
  • 复制链接或嵌入笔记:可将诗歌 PDF 或 MP3 嵌入笔记,或者复制链接到笔记。
  • 分享 / 复制文件:在诗歌右边的「⋯」菜单里点「分享 PDF」或「分享 MP3」,就能把文件交给其它软件。
    • 手机(安卓 / iOS):弹出系统分享面板,直接选微信、QQ 等发出去。
    • 电脑:因为电脑没有系统分享面板,所以改成复制文件本身——点一下,文件就进了剪贴板(等同于在文件夹里选中它按 Ctrl+C),再到微信 / QQ 窗口按 Ctrl+V(⌘V)粘贴即可。
    • 万一某台电脑复制不了,会自动打开这个文件所在的文件夹并选中它,按 Ctrl+C 就能复制;同时也会把文件的完整路径复制好。
  • 长按定位:搜索结果里长按一首诗歌,跳到它在分类中的位置;搜索框右侧出现返回按钮,点击回到原搜索界面(位置保留),重新输入检索则自动消失。
  • PDF 滑动切歌:侧边栏预览 PDF 时左右滑动(或鼠标拖拽)即可切到上一首 / 下一首。
  • 投影:Obsidian 一启动就能按 P 开诗歌窗口投影、按 O 开诗歌全屏投影,不用先打开诗歌面板;也可以点右上角按钮选。没在预览诗歌时照样能打开,画面会提示怎么选一首。打开后再按同一个键就关闭,按另一个键则在两种投影间切换;无论当前是什么状态,P 恒窗口、O 恒全屏。
    • 切模式:点左上角模式按钮,可选「诗歌全屏 / 诗歌窗口」,或切到经文的逐节 / 并列 / 混合投影;没装 Bible Search and Reader 时经文项会置灰说明。点当前模式只收起菜单,不会关掉投影。
    • 翻页 / 换诗歌:↑ ↓ 翻节(PageUp / PageDown、鼠标滚轮同样),Home / End 跳首末页;← →(及左右滑动)在你点进来的那份列表里换上一首 / 下一首——从搜索结果点进的就在这批结果里翻,从播放列表 / 诗歌选择面板点进的就在该列表里翻,没设来源时按「最近打开」走。滑动方向:从右往左=下一首,从左往右=上一首(鼠标横拖同效)。方向:历史记录从上往下是上一首,搜索结果 / 播放列表 / 诗歌列表从上往下是下一首。
    • 最近打开=投影历史:投影里打开过的诗歌与侧边栏的「最近打开」是同一份记录,会写进插件数据、重启 Obsidian 后仍在;默认保留 50 首,可在「设置 → Hymns → 最近打开记录数」改成 1–200(调小会立即裁剪旧记录)。在侧边栏预览或播放过的诗歌,投影里按 ← → 也能翻到。在「最近打开 / 历史」里点一首只是回看,不会把它顶到最上、也不刷新面板位置;只有从搜索、列表或别处播放它时,顺序与位置才会更新。
    • 找诗歌:顶部搜索框输入编号 / 歌名 / 歌词,点候选直接切;焦点不在搜索框时按 Enter 就把焦点交给它。长按搜索框(或长按 Enter 确定键)打开「诗歌选择」面板——左边选诗歌分类,右边按首数分组(0=1–99、1=100–199 …… S=附录),再点分组看该组诗歌;↑ ↓ 选择、→ 确认并投出、← 逐级返回,关掉再开仍停在原处,重启 Obsidian 才回默认。
    • 历史记录 / 播放列表按钮:播放 ▶ 与 ⛶ 之间多了两个按钮。点「🕘 最近打开」看完整记录(正在投影的那首会高亮),点任意一条立即投影;点「🎵 播放列表」先选一张列表(含「当前播放列表(实时)」),再点列表里的诗歌投影,不会改动当前播放列表。两个面板都在投影层内,整屏时也看得见;列表可用鼠标滚轮滚动,也能用 ↑ ↓ / PageUp PageDown 移动高亮、Home / End 跳首尾、Enter(确定键)直接选中当前诗歌。点过的那首再回来看会被标出来,方便接着看下一首。面板打开期间其它投影快捷键一律让行;Esc 先收面板,再按一次才关投影。
    • 诗歌选择面板:上面那两个按钮之外的第三个入口——**长按搜索框(或长按 Enter)**打开。左边选诗歌分类,右边按首数分组(0=1–99、1=100–199 …… S=附录),点分组看该组诗歌,← 逐级返回。这个面板里 ↑ ↓ 选择、→ 确认并投出、← 返回,按确定键不会确认(避免误投);焦点点回搜索框时面板自动收起。左栏对齐搜索框左侧,重开停在原处,重启 Obsidian 才回默认。
    • 与经文投影互切:搭配「Bible Search and Reader」5.2.0 或更新版时,按 Q / W / E 切到经文投影,再按 O / P 回来,原来那首诗歌连第几节都还在;从诗歌全屏切过去仍是经文全屏,从诗歌窗口切过去仍是经文窗口,连续来回切换也不会串状态。
    • 播放:右上角 ▶ 或空格键打开底部播放条并播放这首诗歌的 MP3,可暂停 / 拖进度 / 看时间;播放条会让出下方空间并让页面重新排版,绝不挡住 PDF 的字。
    • 窗口模式(默认):只占满 Obsidian 窗口;左上角模式按钮、搜索框和七个操作按钮都在顶部同一行,窄屏自动排成两行。桌面端按住顶部空白处拖动的是整个 Obsidian 窗口,移动端不会拖动投影图层;Esc 或点右上角 ✕ 都能退出。
    • 整屏投影(桌面端):O 一步进整屏,整屏里再按 O 关闭、按 P 切回窗口;Esc 随时退出整个投影。右上角 ⛶ 按钮同效,移动端不支持整屏。
    • 页面自动等比适配:区域偏宽时适应高度(左右留黑边),区域偏高时适应宽度(上下留黑边),任何比例下都不会超出界面或被裁切。
  • 文件名不带歌名也能显示歌名:儿童诗歌(E001)、新歌颂咏(X001)这类只叫编号的 PDF,歌名只印在 PDF 正文里;插件会用歌词索引里从正文抽出的标题自动补齐,列表、搜索、歌词页都会显示真正的歌名。扫描版(无文本层)的 PDF 抽不出标题,仍显示分类名。
  • 可自行更换 PDF 和 MP3:如果你有更好的 PDF 或 MP3 资源,可自行替换原始文件,也可新增文件,只要按照命名规律改名字即可。

文件命名与配对规则

插件靠文件名把 PDF 和 MP3 配成一对:

PDF 对应 MP3 说明
D001.…pdf d001.mp3 正歌:字母 + 补零编号
Ds1.…pdf / C附2…pdf d-1.mp3 / c-2.mp3 附录(短歌、补充):MP3 用字母 + 横杠 + 数字
D388-1…pdf(第 2 版) d388-2.mp3 同编号多版本:横杠在数字之后表示第几版

附录到底写成 s(如 Ds1)还是「附」(如 Q附1),以你仓库里 PDF 的实际写法为准——MP3 只要写成 d-1 / q-1 就能对上。

  • 自动检测更新:启动时比对云端版本,发现新版本弹通知,更新后展示更新说明并可查看历史。

安装

方式一:Obsidian社区安装

1.插件市场搜索、安装、启用Hymns(约 1.5 MB,可能需要科学上网)

2.由于诗歌PDF与 MP3体积较大(约 4 GB),请到 QQ 群 1128049033 另行下载,解压到你 Obsidian 仓库的任意位置。obsidian启动时,插件会自动扫描仓库中的诗歌PDF与MP3,并自动创建诗歌索引和歌词索引。下载好之后,所有的功能均在本地实现。

方式二:手动安装(GitHub)

  1. 下载本仓库 main.js / styles.css / manifest.json 三个文件
  2. 在 Obsidian 库里新建文件夹 .obsidian/plugins/hymns/,把三个文件放进去。
  3. 重启 Obsidian,在「设置 → 第三方插件」中启用 Hymns。
  4. 首次使用在插件设置里指定 PDF 文件夹与 MP3 文件夹(留空 = 扫描整个仓库)。 5.由于诗歌PDF与 MP3体积较大(约 4 GB),请到 QQ 群 1128049033 另行下载,解压到你 Obsidian 仓库的任意位置。obsidian启动时,插件会自动扫描仓库中的诗歌PDF与MP3,并自动创建诗歌索引和歌词索引。下载好之后,所有的功能均在本地实现。

方式三:BRAT

  1. 在 BRAT 中添加本仓库 ViaCai/Hymns 即可。 2.由于诗歌PDF与 MP3体积较大(约 4 GB),请到 QQ 群 1128049033 另行下载,解压到你 Obsidian 仓库的任意位置。obsidian启动时,插件会自动扫描仓库中的诗歌PDF与MP3,并自动创建诗歌索引和歌词索引。下载好之后,所有的功能均在本地实现。

设置

  • PDF 文件夹 / MP3 文件夹:留空 = 扫描整个仓库。诗歌靠文件名编号识别(如 D116、E836(补充版))。
  • 重建索引 / 歌词索引:改了文件夹或新增诗歌后重建。
  • 更新:自动检查更新开关、立即检查更新、查看当前版本说明、查看历史更新。

发布(提交 Obsidian 官方插件市场)

本仓库采用「打 tag 自动出 Release」的流程,无需手动在 GitHub 建 Release。

  1. 在 CHANGELOG.md 顶部写好新版本的更新内容(按 ## [x.y.z] - 日期 格式)。
  2. 运行一键发版脚本(会自动改 manifest.json / versions.json、提交、打 tag、推送):
    node scripts/release.mjs 1.0.1
    

    首次发布当前 1.0.0 时,直接打 tag 即可:

    git tag 1.0.0 && git push origin 1.0.0
    
  3. GitHub Actions 会自动创建 Release,并附上 main.js / styles.css / manifest.json。
  4. 到 obsidianmd/obsidian-releases 提 PR,在 community-plugins.json 加入:
    { "id": "hymns", "name": "Hymns", "author": "ViaCai", "repo": "ViaCai/Hymns" }
    

插件自身的自动检测更新读取的是 main 分支的原始文件,与官方市场的 Release 分发互不冲突,二者可同时生效。

目录结构

hymns/
├── main.js          # 插件主体
├── styles.css       # 样式
├── manifest.json    # 插件元信息
├── lib/             # 开发用:PDF.js 源文件(发布版已内联进 main.js,安装时不需要此目录)
├── versions.json    # 各版本最低 Obsidian 版本
├── CHANGELOG.md     # 更新日志
└── README.md

English

Hymns — an Obsidian hymnal plugin

Browse, search, play and bookmark hymns: instant search by number (e.g. D116) or keywords, PDF preview, MP3 playback, favourites and playlists. Works on desktop and mobile.

Supported hymn series

The plugin recognizes the following hymn series by their file-name prefix and groups them accordingly:

  • Great Hymns (大本诗歌, D)
  • Supplementary Hymns (补充诗歌, B)
  • Hymn Writers (唱诗人, C)
  • New Songs of Praise (新歌颂咏, X)
  • Children's Hymns (儿童诗歌, E)
  • Youth Hymns (青年诗歌, Q)
  • Special Meeting Hymns (特会诗歌, T)
  • Other Hymns (其他诗歌, O) — a catch-all group for anything that does not match the series above

Installation

Manual installation:

  1. Download main.js, styles.css and manifest.json from the latest release.
  2. Create the folder <your-vault>/.obsidian/plugins/hymns/.
  3. Put the three files into that folder. These three files are all you need — PDF.js is bundled inside main.js.
  4. Reload Obsidian, then enable Hymns in Settings → Community plugins.

Via BRAT: add ViaCai/Hymns in the BRAT plugin and let it install the latest release.

Usage

  1. Put your hymn PDF/MP3 files anywhere inside your vault. The folder names are configurable in the plugin settings — leave them empty to scan the whole vault.
  2. Hymn numbers are detected from file names, e.g. D116 <title>.pdf or D116-<title>.mp3.
  3. On every startup the plugin scans the vault and builds the hymn index and the lyrics index automatically.
  4. Open the Hymns view from the ribbon, then search, preview the PDF and play the MP3. In the sidebar, click the icon at the far right of the panel title bar to open a second, full-size Hymns panel in a new tab (the button is not shown inside the tab itself). The tab switches between a two-column layout and the single-column sidebar layout according to the window width (phone landscape is usually two-column, portrait single-column). In two-column mode the left column holds the list / search results / PDF preview; the right column runs top to bottom: "Recently opened" & "Playlists" → the search bar (while browsing) or the preview buttons (while previewing a PDF) → the MP3 player.
  5. Copy a link or embed to your note — on any hymn, open the "more" (⋯) menu and copy a wiki link or an embed for its PDF or MP3, e.g. [[D116.pdf]] or ![[D116.pdf]] (and the same for MP3). Paste them straight into any note.
  6. Long-press to locate — long-press a hymn in the search results to jump to its position in the category list; a back button appears next to the search box to return to the original search view (previous position kept). Typing a new search dismisses the button.
  7. Swipe in the PDF preview — swipe left/right (or drag with the mouse) in the sidebar PDF preview to go to the previous / next hymn. Vertical scrolling is unaffected.
  8. Replace or add your own PDF/MP3 — if you have better audio or scanned PDFs, just replace the existing files or drop in new ones following the same naming rule. The plugin re-indexes on the next startup, or you can trigger it with Rebuild index in the settings.
  9. Share or copy a file — open the "more" (⋯) menu on any hymn and choose Share PDF / Share MP3 (shown as Copy PDF file / Copy MP3 file on desktop).
    • On phones (Android / iOS) the system share sheet opens, so you can send the file straight to WeChat, QQ, etc.
    • On desktop there is no system share sheet, so the file itself is copied to the clipboard — just press Ctrl+V (⌘V) in the target app.
    • If copying is not possible on that machine, the file's folder is opened with the file selected, so you can still press Ctrl+C; the full file path is copied as well.

Settings

  • PDF folder / MP3 folder — leave empty to scan the whole vault.
  • Link PDF and MP3 — follow the current hymn in both viewers.
  • Rebuild index / Rebuild lyrics index — rebuild after adding or moving files.
  • Updates — toggle the automatic update check, check for updates now, view the current changelog and the update history.

Notes on plugin behavior

  • Vault enumeration — the plugin lists the files in your vault in order to locate hymn PDF/MP3 files. This is required so that you do not have to configure each file manually.
  • Clipboard access — used when you click "Copy lyrics", or when you use "Share / Copy file" for a PDF or MP3.
  • External commands (desktop only) — clicking "Copy PDF file" / "Copy MP3 file" runs a built-in OS command to place that one file on the system clipboard: powershell on Windows, osascript on macOS, xclip (or wl-copy) on Linux. Only the absolute path of the selected hymn's file is passed as an argument; the command runs solely in response to your click, nothing is downloaded, and no other command is ever executed.
  • Dynamic code execution — the bundled PDF.js library is evaluated with new Function inside an isolated sandbox object (evalPdfLibIsolated). This keeps the library out of the global scope and allows PDF rendering to work on mobile without a Web Worker. All code is bundled locally inside main.js — nothing is downloaded or executed from the network.

License

MIT — see LICENSE.

This plugin bundles PDF.js v3.11.174 (Apache License 2.0); its copyright and license notice are preserved inline in main.js.


许可证

MIT License(见 LICENSE)

本插件内联打包了 PDF.js v3.11.174(Apache License 2.0),其版权与许可声明随源码一并保留在 main.js 中。

☕ 如果觉得这款插件对您有帮助,也可以支持我的项目

加6:10 所以我们有了时机,就当向众人行善,尤其是向信仰之家的人。