おんがえしの blog

作ったプログラムと調べた技術情報

うさかめゲームエンジンを作っている

エージェントと一緒にソフトウェア開発をいくつかしてきたことによる重要な発見に、「自分が本当に必要としていたり、強いモチベーションやバックグラウンドの知識があるもの」でないと開発が続かない、というのがある(適当にプロンプトを打って適当なアプリケーションができあがり、虚無になることが何度かあった)。

Previous RiverやObsidian Daily Appenderは自分が必要としているもので今も使えている。では、強いモチベーションがあるものはなんだろう? ということで、何度もチャレンジして途中でやめてしまっていた「Rubyで書けるゲームエンジン」に再度チャレンジすることにした。失敗例も持っているし、類似ツールもたくさん触っているので、アイデアや良し悪しの判定は出せるはずだ。

まずは Web の Gemini で壁打ち。

シングルスクリプトゲームエンジンというのを作りたいと考えています。

仕様は以下のようなものです。

1. プログラム、グラフィックス、サウンド全てのリソースを1つのスクリプトだけで記述可能。
2. グラフィックやサウンドのデータはソースコードの1番下にデータ配列として配置する。
3. 自力でグラフィックやサウンドを作らなくてもゲームが作れるように標準で用意された組み込みリソースを使うこともできる。
4. 絵文字をドット絵のように表示することも可能。ゲームプログラムに集中できるように。
5. PICO-8 のような解像度などに制限のある環境を想定。
6. 作成したゲームはスクリプトで配布、ブラウザゲームとしてデプロイ、1バイナリ(リソースファイル不要!)で配布することができる。

このような環境を構築するのに最適な開発言語、採用するスクリプト言語、また類似のものがすでにあるかも含め案を練ってください。

Rust + Macroquad、 Go + Ebitengine、C + Raylib、などが候補に挙がる、Raylibは過去にやったことがあるので今回は使わないことにする。WASM出力時のファイルサイズが小さくなりやすいという情報を元に Rust を選択。

スクリプトは JavaScript/TypeScript や Lua を勧められるので追記。

スクリプトエンジンとしてruby やmrubyを使うことはできますか?

とてもいいんじゃないかと言われる。シングルスクリプトでゲームを作るときに__END__の仕様があるのがよさそうという指摘。なるほど。

次は Ruby のどの処理系を使うか。CRuby, mruby のどちらにするか聞かれる。

mrubyが良さそうに思いました。シングルバイナリ化とブラウザ実行のためのWASM化を考えるとrust+macroquad+mrubyの構成が優位に感じましたがどう思いますか?

ここから落とし穴の指摘。C言語版のmrubyは setjmp / longjmp を使う理由で Rust 標準のWASM化ができないらしい。ブラウザで動かすときに大変だそう。Gemini 優秀。Googleで色々探してみるとそういうば Rust 上で mruby 作っているという話を Rubykaigi のスライドで見た気がする…。

https://mrubyedge.github.io/playground/ を使うのはどうですか?

素晴らしいアイデアとのこと。これでブラウザで動かせるはず。Gemin の壁打ちはここまで。

ありがとうございます。ここからはAntigravityを使ってPC上で進めようと思います。

今までの文脈を全て正確にAntiravityに渡せるようにプロンプトを作成してもらえますか?

  最初は「Rustからmrubyを呼び出し、スクリプト末尾の配列データを読み取って128×128の画面(Macroquad)にドット絵を描画する最小構成(⁠build.rs⁠ 含む)」から始めようと思います。

ここから Antigravity↓


# 役割
あなたはゲームエンジンの開発パートナー(Rust / mruby / Macroquadのエキスパート)です。
これから、PICO-8のようなレトロな世界観を持つ「シングルスクリプトゲームエンジン」をゼロから構築します。

# 全体の仕様(前提知識)
1. プログラム、グラフィックス、サウンド全てのリソースを1つのスクリプト(Ruby)だけで記述可能。
2. グラフィックやサウンドのデータはソースコードの1番下にデータ配列として配置する(`__END__` または末尾のハッシュ/配列)。
3. 標準の組み込みリソース(スプライトや効果音)も呼び出せる。
4. 絵文字をドット絵のように表示することも可能。
5. 解像度やパレット数に制限のある環境を想定(例: 128x128、16色)。
6. ブラウザゲーム(WASM)としてデプロイでき、リソースファイル不要の1バイナリ(単一ファイル)として配布できる。

# 技術スタックの選択
- **ホスト言語 / 描画・音声フレームワーク**: Rust + Macroquad
- **スクリプトVM**: `mruby/edge` (100% Pure Rust製のため、WASM/ネイティブともにビルドが容易)
- **ゴール**: 開発時は`.rb`を書き、配布時は1バイナリ化(またはWASM化)できる仕組みを目指す。

---

# 今回のタスク:最初のマイルストーン
まずは以下の**「最小構成のプロトタイプ」**のコードを実装したいです。

【要件】
1. **Cargoプロジェクト構成**(`Cargo.toml`)の提示
2. **ビルドスクリプト(`build.rs` 等が必要な場合)** の提示
3. **Rustのメインコード(`src/main.rs`)** の提示
   - Macroquadで 128x128 の仮想スクリーン(あるいは拡大ウィンドウ)を表示する。
   - `mruby/edge` を用いて、起動時にRubyスクリプトを読み込み、毎フレーム `update` と `draw` を呼び出す。
   - スクリプトの末尾(または `__END__` 以降)に記述されたカスタム配列(ドット絵データ)をRust側でパースし、Macroquad側でドット絵として描画する。
   - エンジン側から `spr`(スプライト描画)や `cls`(画面クリア)のAPIをRuby側に提供する。

まずは、この最小構成を動かすための具体的なファイル一式(Cargo.toml と src/main.rs、およびサンプルとなるRubyスクリプト)を作成してください。

できた。

https://github.com/ongaeshi/usakame

サンプルゲームを作らせてみるとヴァンサバ風ゲームを作ってきた。 ※ 調整が甘くて大分簡単ではある。

しばらく開発を続けていきます。

ネットのセトリやLLMの出力テキストをそのまま再生する。Spotify特化のテキストプレイヤーを作った

text-spotify-playerは、テキストデータを入力としてSpotifyの楽曲検索および再生制御を行うWebアプリケーションです。

「ザ・ウィークエンドのお気に入りの邦楽プレイリスト」のようなWeb記事や、X(旧Twitter)のタイムラインに流れてくるライブのセトリなど、テキスト形式で列挙された楽曲リストを、手作業で1曲ずつ検索することなく、そのまま再生したくて作りました。

text-spotify-player

このツールは、テキストエリアに複数行の楽曲情報をペーストすることで、各行を対象に一括検索を実行します。「アーティスト名 / 曲名」といった形式的な入力だけでなく、「アニメタイトル 主題歌」などの曖昧な検索キーワードにも対応しており、該当するトラックやエピソードを取得します。

テキストエディタの操作性でプレイリストを編集できるのも特徴です。行を入れ替えば再生順を変更でき、一時的に再生対象から除外したい行には先頭に「#」を付与してコメントアウトできます。曖昧な指定で検索された行については、プレビュー表示横の「Fix Name✨️」ボタンを押して、入力テキストを正式な曲名表記へ直接置換できます。

ブラウザ単体で音声を再生する機能(Force playback on this device)に加え、スマートフォンなど現在アクティブな別デバイスの再生キューへ一覧の楽曲を一括登録する「Queue All」ボタンも備えています。

Spotifyの規約変更により一般ユーザー向けマルチユーザーアプリの新規公開が制限されているため、本アプリケーションは GitHub 上でオープンソースとして公開されています。自身の環境へデプロイすることで、制限の影響を受けずに個人用プレイヤーとして利用可能です。

プロンプト

おすすめの使い方としては、LLMに以下のようなプロンプトを投げ込みます。

テーマやキーワードを渡すので、以下の条件を厳格に守ってプレイリストを作成してください。

# 出力形式・ルール
- 前置き、挨拶、解説などの余計なテキストは一切出力せず、コードブロック内のみを出力すること。
- コードブロックの種類は markdown とすること(```markdown ... ```)。
- 各行は「アーティスト名 / 曲名」のフォーマットとし、連番や記号などのプレフィックスは付けないこと。
- 10曲選出すること。

# 出力例
テーマやキーワードを渡すので、以下の条件を厳格に守ってプレイリストを作成してください。

# 出力形式・ルール
- 前置き、挨拶、解説などの余計なテキストは一切出力せず、コードブロック内のみを出力すること。
- コードブロックの種類は markdown とすること(```markdown ... ```)。
- 各行は「アーティスト名 / 曲名」のフォーマットとし、連番や記号などのプレフィックスは付けないこと。
- 10曲選出すること。

# 出力例
```markdown
アーティスト名1 / 曲名1
アーティスト名2 / 曲名2
```

# テーマ
悪いなここからは通行止めだ

LLMの返信。

凛として時雨 / abnormalize
THE ORAL CIGARETTES / 狂乱 Hey Kids!!
LiSA / 炎
MAN WITH A MISSION / Raise your flag
SiM / The Rumbling
Ado / 逆光
FLOW / GO!!!
UVERworld / D-tecnoLife
coldrain / Feed the Fire
Survive Said The Prophet / MUKANJYO

例えば、その日に読んだ漫画のお気に入りのフレーズからプレイリストを作らせて、それを text-spotify-player に貼り付けて再生させると捗ります。興味のある人は是非お試しください。

リンク

github.com

Previous River 1.4 で階層構造も表現できるようにした

Obsidian プラグイン Previous River 1.4 をリリースしました。

community.obsidian.md

これまでのバージョンでは、previous プロパティを数珠つなぎに指定することで、ノート同士のシーケンシャル(直列)な構造を作ることができました。

1.4 の新機能:親ノートを指定した階層構造のサポート

バージョン 1.4 からは、複数の子ノートが previous プロパティで同一の親ノートを指すことで、階層構造(ツリー構造)も表現できるようになりました。

親ノート側で子ノートを動的に集約表示

今回のポイントは、親ノート側から Insert base to collect next notes コマンドを実行するだけで、紐づく子ノート一覧を動的に埋め込める点です。

Previous River が Obsidian の機能であるコードブロックとしてのベース埋め込みを自動生成するので、Bases のクエリ構文を詳しく知らなくても手軽に子ノート一覧を確認できます。

```base
views:
  - type: list
    name: All
    filters:
      and:
        - previous == link(this.file)
```

内部クエリには this.file を使用しているため、親ノートのファイル名をリネームしても参照が壊れず追従します。


以前の記事でも触れましたが、プロパティのリンクを Base で抽出するアプローチは非常に強力です。

直列のシーケンス管理だけでなく、フォルダに頼らないシンプルな親子構造の整理にも役立ちます。手軽に使えるプラグインですので、ぜひ一度お試しください。

Rubyで作ったCLIツールをGo, Rust, C#で書き直してベンチマーク比較してみた

プログラムのコンポーネント部品を量産する際など、ファイルをコピーしつつ、ファイル名や内容を特定のパターンで置換できるツールが必要でした。そこで、hyper_copy というCLIツールを開発しました。

本記事では、このツールの開発から複数言語での実装、ベンチマーク、そしてリリースまでの過程を技術メモとして記録します。

開発のプロセス

作業の大部分は、AntigravityのRemote Controlからの指示で行った。実際の手順は以下の通り。

  1. Rubyによる初期実装と命名 第一弾としてLLMにRubyスクリプトで実装を依頼した(コミット: aff7225)。動作が心地よく実用的だったため、「hyper_copy」と命名した。
  2. 複数言語(C#, Go, Rust)での実装 Rubyがインストールされていない環境でも利用できるよう、Rubyスクリプトをベースに Go, Rust, C# で動くバージョンを作成させた(コミット: 7ecb576)。
  3. テストスクリプトによる動作保証 各言語の実装が正しく動作することを保証するため、共通で動作するテストスクリプトをRubyで作成し、すべての言語でテストが通ることを確認した(コミット: 6ba5902)。
  4. ベンチマークテストと実行性能の比較 それぞれの実行性能を確認するため、全言語で動作するベンチマークテストを作成させた(コミット: 85b3a1a, fb6d6b9)。実行時間とバイナリサイズを比較し、C#については.NETランタイムが必要な通常版と自己完結型(self-contained)の両方を計測した。(※詳細な比較表はリポジトリのREADMEを参照)
  5. GitHub Actionsによる自動リリース 作成したバイナリを別のPCからも手軽にダウンロードできるよう、GitHub Actionsを利用したリリースワークフローを構築した(コミット: 2da0bae)。
  6. 大文字・小文字の保持(Preserve Case)挙動の修正 手元で動かした際、FooBar -> AaaBBB のような置換パターンにおいて、VS Codeの「Preserve Case」オプションと異なる挙動を示すことが判明したため、期待通りに置換されるようアルゴリズムを修正した(コミット: 2756ddd)。

実際の動作確認は手元で行ったが、それ以外のGitHub Actionsなどの変更はリモート環境および github.com 上で確認するだけでスムーズに進めることができた。

まとめ(所感)

出来上がったコードの行数や性能を比較することで、コードのシンプルさ、バイナリサイズ、実行時間、ポータビリティ製と、Goのバランスのよさがよく分かりました。また、環境に.NETがインストールされている前提であれば、C#のバイナリサイズはさらに小さく、実行性能やコードのわかりやすさも魅力的です。

今回のようにライブラリを必要とせず、使用頻度的にそこまで厳密な実行性能を求めないツールであれば、まずはRubyなどのスクリプト言語で書いてしまうのも良いアプローチだと感じました。Windows であれば、実行コマンドを

@echo off
ruby "C:\path\to\hyper_copy.rb" %*

のようにbatファイルでラップすれことで普通のコマンドのように使うこともできますし、再コンパイルなしで即座に挙動を変更できる柔軟性は大きな利点です。将来的にバイナリでの広範な配布が必要になった際に、今回のように他言語へ書き直すという手順は今ではより合理的になったと考えてよさそうです。

Obsidianでタグを使わずにノートを自動集約する方法:プロパティとBasesの活用

はじめに

Obsidianで読書記録やタスクを管理する際、プロパティを活用すると条件に応じたノート一覧を自動生成できます。一般的なタグ管理と比較して、プロパティと内部リンクを組み合わせることで柔軟な絞り込みや階層構造の表現が可能です。

この記事では、標準機能のBasesを用いた一覧表の作成手順と、階層型メニューの実装方法を解説します。また、動作確認用のサンプルVaultも提供します。

一覧表を構築することで、ノートが増加しても過去の記録を迅速に参照できるようになりObsidianに色々なデータを貯めていくのが楽しくなるのでおすすめです。

サンプルVault

動作確認用のサンプルVaultは以下のリポジトリからダウンロードできます。

※ Obsidianでの起動手順や基本設定は、リポジトリ内の解説(README)を参照してください。

一覧表の作成手順

タスク管理を例に、一覧表を構築する手順を解説します。この仕組みを実現するには、以下の3種類のノートが必要です。

  • TODOテンプレート: 1つのタスクノートを作成するためのテンプレートファイル。
  • タスクノート群: テンプレートから生成された個別のノート。同一Vault内であれば任意の場所に配置できます。
  • カテゴリノート(TODO.md): 生成されたタスクノート群を一覧表として集約・表示する親ノート。

1. タスクノート側のプロパティ設計

テンプレートおよび生成された各タスクノートのFrontmatterには、以下のプロパティを定義します。

---
categories:
  - "[[TODO]]"
created: 2026-08-30
finished:
---
  • categories: カテゴリノート([[TODO]])への内部リンクを指定します。
  • created: ノートの作成日。
  • finished: タスクの完了日。未完了の場合は空にしておきます。

2. カテゴリノート(Bases)のビュー定義

集約先となるカテゴリノート(TODO.md)内にBasesブロックを配置し、抽出条件を設定します。

views:
  - type: table
    name: TODO
    filters:
      and:
        - file.name != "TODOテンプレート"
        - categories.contains(link("TODO"))
        - finished.isEmpty()
  - type: table
    name: すべて
    filters:
      and:
        - file.name != "TODOテンプレート"
        - categories.contains(link("TODO"))

設定のポイント

  1. テンプレートノートの除外 (file.name != "TODOテンプレート") テンプレート自身もFrontmatterに categories: "[[TODO]]" を持つため、除外条件を設定しないとテンプレートファイルが一覧表に混入します。file.name != "..."(またはfile.folder != "Templates")を条件に含めることが重要です。

  2. 内部リンクの判定 (link("TODO")) categories プロパティに含まれる内部リンクは、categories.contains(link("TODO"))` で正確に照合します。

  3. 未完了状態の判定 (finished.isEmpty()) TODO ビューでは finished.isEmpty() を指定することで、完了日が入っていない(未完了の)タスクのみを自動抽出します。

  4. 全件表示の切り替え(すべてビュー) 左上のビューメニューを「すべて」に切り替えることで、完了済み(finished に日付が入ったタスク)を含む全履歴を確認できます。

階層型メニュー(MoC)の実装

プロパティに設定した内部リンクを活用することで、Vault内に階層的なナビゲーション構造を構築できます。

サンプルVaultでは、各カテゴリノートの上部に共通の親ノートであるカテゴリへのリンクを配置しています。これにより、以下のような階層的な動線が形成されます。

各タスクノート
  └─ プロパティからリンク → [[TODO]](タスク一覧)
       └─ 上部リンクから移動 → [[カテゴリ]](全カテゴリ一覧のハブ)
            └─ リンクを選択 → [[永続メモ]](別のカテゴリ一覧)

個別のタスクノートからプロパティ経由で一覧表へアクセスできるだけでなく、カテゴリハブを中継して別のカテゴリ一覧へもクリック操作のみで遷移できます。専用のメニュープラグインやサイドバーの設定に依存せず、Vault全体を階層型メニュー(MoC: Map of Content)として運用できます。

おわりに

タグはノート内の任意の位置から設定でき便利ですが、クリックするたびに検索処理が実行されるため表示に時間がかかります。また、Basesで専用の一覧表を作成した場合でも、そのページへアクセスするための導線が必要です。

プロパティのリンクを活用して一覧表を構築すると、プロパティ自体がカテゴリノートへの導線として機能します。過去の記録へのアクセス性を高めることは、ナレッジの再利用性を向上させる重要な要素です。サンプルVaultを参考に、是非ノート一覧化の仕組みを導入してみてください。

関連記事

私の Obsidian の使い方 - デイリーノート・タスク・メディア・永続メモを1つの Vault に集約する

Obsidian を本格的に使い始めて6年位が経ちました。

色々なパターンを試しましたが、最終的にはデイリーノート、タスク管理、メディア管理、永続メモと、必要なものは1つの Vault に集約されました。

試行錯誤を重ねて Vault の設計がようやく固まったので、テンプレートとして GitHub に公開します。

ongaeshi/ongaeshi-obsidian - GitHub

以下のような悩みがある方には役立つ情報があるかもしれません。

  • Obsidian を使い始めたが、フォルダ構造が定まらない
  • 他の人がどのように Vault を運用しているのか知りたい
  • デイリーノートとタスク管理を連携させたい
  • 書籍や映画などの体験したメディアの情報を一元管理したい

この Valult で管理しているもの

  • 日々を記録する——デイリーノートとウィークリーノートでライフログを残す
  • タスクを追跡する——TODO をチェックボックスやノート単位で柔軟に扱う
  • 読書の進捗を把握する——本や記事を「いま読んでる / 読み終わった」で分類する
  • 触れたメディアを記録する——書籍・音楽・漫画・ゲーム・映像を一元的に記録・評価する
  • 思考を蓄積する——Zettelkasten(メモを相互にリンクして知識のネットワークを構築する手法)の永続メモで知識を育てる

教条的なルールを押し付ける意図はありません。気に入った部分だけ取り入れて、自由にカスタマイズしてください。

使い方

  1. git clone https://github.com/ongaeshi/ongaeshi-obsidian.git
  2. クローンしたリポジトリを Obsidian で Vault として開く。
  3. デイリーノートやウィークリーノートを開き、Alt+, と Alt+. で前後のノートに移動する(ホットキーはお好みのものに変更してください)。
  4. Categories/ フォルダ内のノートを開き、カテゴリごとにノートを一覧する。各ノートの categories プロパティのリンクからもカテゴリノートに移動できる。
  5. ノートを作成するときは適切なテンプレートを選ぶ。日々の記録や各データの確認は Categories/ フォルダ内のビューから行う。

フォルダ構造の全体像

ongaeshi-obsidian/
├── 01_Inbox/          # 新規ノートの一時置き場
├── 02_Daily/          # デイリーノート & ウィークリーノート
│   └── 2026/
│       └── W32/       # 年 → 週番号でフォルダを分ける
├── 03_Project/        # PARA: 進行中のプロジェクト
├── 04_Area/           # PARA: 継続的に管理する領域
├── 05_Resource/       # PARA: 参考資料
├── 06_Archive/        # PARA: 完了・アーカイブ
├── 07_Thinking/       # 永続メモ
│   ├── 00_文献メモ/
│   ├── 01_思い付きメモ/
│   └── 02_永続メモ/
├── Categories/        # カテゴリ(Bases による一覧・集計)
├── Clippings/         # Obsidian Web Clipper
└── Templates/         # Templater

各フォルダに 01_〜07_ の数字プレフィックスを振ることで、クイックスイッチャーでの絞り込みが劇的に速くなります。たとえば 72 と入力するだけで、07_Thinking/02_永続メモ/ 配下のノートに一瞬でたどり着けます。

中盤のフォルダ(03_Project〜06_Archive)は、Tiago Forte が提唱する PARA メソッド(情報を Project・Area・Resource・Archive の4種類に分類する整理法)に基づいています。

フォルダ構造はかなりしっかり分けていますが、後述するカテゴリの仕組みでノートを横断的に一覧できるため、「このノートはどのフォルダに入れるべきか」と悩みすぎる必要はありません(Area と Resource の使い分けなど私も曖昧です…)。

デイリーノート

デイリーノートのテンプレートです。

Templates/デイリーノートテンプレート

---
睡眠: 6.0
previous: "[[2026-08-05]]"
trained:
  - ストレッチ10分
---

## TODO
- [x] 今日の TODO
- [ ] 図書館で本を借りる

![[2026-W32#今週のTODO]]
## つぶやき
13:42 肩こりがひどいのでストレッチを長めにした。

---
14:26 みたい本がいくつかあるので週末に本屋も行きたい。

このテンプレートは、睡眠時間、前日ノートへのリンク、トレーニング内容、1行 TODO(ノートに分けるほどでもない単発タスク)を記録します。つぶやき欄には Obsidian CLI 経由で時刻とつぶやきを書き込めるようにしています。

previous プロパティにリンクを設定すると、Previous River プラグインで日付を前後にたどれます。「昨日何をしていたっけ?」がすぐにわかります。

特に気に入っているのは ![[2026-W32#今週のTODO]] による埋め込みです。ウィークリーノートに書いた「今週のTODO」がデイリーノートを開くたびに目に入るので、タスクの確認漏れがなくなりました。

ウィークリーノート

ウィークリーノートは GGGG-Www(例:2026-W32)形式で作成します。

Templates/ウィークリーノートテンプレート

---
previous: "[[2026-W31]]"
---

## 今週のTODO
- [x] Obsidianのプラグインを探す
- [ ] 新しいプロジェクトのアイデアをまとめる
- [x] 運動の習慣化について考える

## デイリーノート
.
.

## 睡眠時間
.
.

ウィークリーノートの核は「今週のTODO」です。今週やるべきタスクをここにリストアップし、デイリーノートから埋め込みで参照します。この TODO は一週間ずっと目に留まるため、達成率が大きく向上します。

さらに、Dataview プラグインと Charts プラグインで、その週のデイリーノート一覧を自動生成しています。睡眠時間の集計・グラフ化も自動です。同じフォルダ(W32/)配下のデイリーノートから 睡眠 プロパティを集計し、折れ線グラフで表示します。平均睡眠時間も自動算出されるので、睡眠パターンの振り返りに役立ちます。

グラフ化されたウィークリーノート

カテゴリ

この Vault で最も重要な仕組みがカテゴリです。

カテゴリは2つの要素で構成されます。

  1. テンプレート——ノートを量産するための雛形
  2. カテゴリノート——量産されたノートを Bases(Obsidian 標準のデータベースビュー機能)で一覧するためのファイル

ノートの categories プロパティにカテゴリノートへのリンクを設定すると、Categories/ フォルダのビューファイルからそのノートを横断的に一覧できます。

たとえば、タスク管理の場合は以下の2つのファイルがカテゴリの本体です。

テンプレート

Templates/TODOテンプレート

---
categories:
  - "[[TODO]]"
created: 2026-08-17
finished:
---

## ログ

created: 2026-08-17 は Templater プラグインの機能で、ノート作成時の日付を自動挿入します。TODO テンプレートから作成したノートは、以下の状態で生成されます。

  1. categories プロパティに TODO ノートへのリンク([[TODO]])が設定される
  2. created プロパティにノートの作成日が入る
  3. finished プロパティは空のまま

※ Obsidian では同一 Vault 内に同名ノートが存在しない場合、ディレクトリパスを省略してリンクを貼れます。そのため categories プロパティのリンクをクリックすると、次に解説する Categories/TODO にジャンプします。

カテゴリノート

Categories/TODO

---
tags:
  - categories
---
```base
views:
  - type: table
    name: TODO
    filters:
      and:
        - file.name != "TODOテンプレート"
        - categories.contains(link("TODO"))
        - finished.isEmpty()
    order:
      - file.name
      - created
      - finished
(省略)

タスク管理用カテゴリノートの本体です。ノート内にインラインで Bases 記法を埋め込んでいます。最も重要な filters を解説します。

filters:
  and:
    - file.name != "TODOテンプレート"        # 1
    - categories.contains(link("TODO"))    # 2
    - finished.isEmpty()                   # 3

AND 条件は3つあります。

  1. ファイル名が「TODOテンプレート」ではない
  2. categories プロパティが TODO へのリンクを含んでいる
  3. finished プロパティが空である

この3条件を満たすノート、つまり未完了のタスクノートだけが一覧に表示されます。

カテゴリノートには、完了済みのノートも含めた一覧ビューも記述してあります。詳細は GitHub のソースを参照してください。

※ categories.contains(link("ノート名")) のフィルタ条件は汎用性が高く、この Vault 内で繰り返し使っています。

タスク管理

デイリーノートの1行チェックボックスに収まらないタスク(経緯や調査メモを伴うもの)は TODO ノートとして作成します。ノートのタイトルがそのままタスク名になり、本文にはログや関連情報を記録します。

TODO一覧

TODO ノートの例です。

日用品の買い物

---
categories:
  - "[[TODO]]"
created: 2026-07-15
finished: 
---

- [x] 食器用洗剤
- [ ] 醤油

## ログ

finished が空なら「未完了」、日付を入れると「完了」として扱います。Categories/TODO を開くと、未完了の TODO と全 TODO の両方を一覧で確認できます。

既読管理

  • テンプレート: なし(手動で categories プロパティに [[読んでる]] を追加)
  • カテゴリノート: Categories/読んでる

カテゴリの仕組みを応用して、書籍や Web クリッパーで取り込んだ記事の既読状態も追跡しています。この仕組みを導入してから、Web クリッパーで取り込んだ記事の読了率が大きく向上しました。

既読一覧

読むのに時間がかかりそうなノートに categories: "[[読んでる]]" を付けておけば、「あとで読む」リストとして機能します。読み終わったノートには finished プロパティに日付を設定します。

categories: "[[読んでる]]" を付けたノートは、Categories/読んでる のビューで「いま読んでるもの」と「読み終わったもの」に自動で分類されます。

メディア管理

書籍、音楽、漫画、ゲーム、映像など、体験したメディアを記録・評価するための仕組みです。

---
categories: "[[メディア]]"
kind: 書籍
created: 2025-10-15
finished: 2026-03-01
author:
  - ズンク・アーレンス
rating: 7
---
私のObsidianのディレクトリ構造の半分はこの本の強い影響下にある。

Categories/メディア.md を開くと、「今年」「書籍」「音楽」「漫画」「ゲーム」「映像」などのビューを切り替えてノートを一覧できます。

メディア一覧
(動画: メディア一覧)

rating プロパティには kepano の7段階レーティングを採用しています。後で振り返るときの比較基準になるため、レーティングは重要です。特に「よい」の評価を細分化することが効果的だと感じています。

永続メモ

07_Thinking/ には Zettelkasten 用のファイルを配置します。

フォルダ 役割
00_文献メモ 本や記事から得た知識のメモ
01_思い付きメモ ふと浮かんだアイデアのメモ
02_永続メモ 上記を昇華した「一生残すメモ」

3つのフォルダのうち、最も重要なのは 02_永続メモ です。永続メモの素材は文献メモや思い付きメモに限りません。デイリーノート、ウィークリーノート、TODO ノート、既読ノート、メディアノート——どこから生まれても構いません。

永続メモの作成には2つのフェーズがあります。

  1. メモを書く——まず永続メモを作成し、finished プロパティを空にしてしばらく寝かせる
  2. リンクを貼る——定期的に未接続の永続メモを見直し、関連する他の永続メモにリンクを貼り、その理由を追記する

finished プロパティが空の永続メモは「未接続」ビューで一覧できます。リンクと理由の追記が完了したら finished に日付を入れ、1つの永続メモが完成します。

使用しているプラグイン

プラグイン 用途
Templater テンプレートの変数展開(日付計算、前日リンクの自動生成など)
Previous River previous プロパティを使った前後のノート移動
Dataview 睡眠時間の集計
Charts 睡眠時間のグラフ化

Previous River は自作プラグインです。デイリーノートやウィークリーノートを previous リンクでたどり、時系列の記録をストレスなく前後に移動できます。

Dataview と Charts は睡眠時間の集計・グラフ化に使用しています。それ以外の集計には Obsidian 標準の Bases を使用しています。

おわりに

この Vault の設計は、以下の Vault や文献から大きな影響を受けています。

Obsidian の Vault 構造に正解はありません。このテンプレートも、6年間さまざまな方法を試した結果たどり着いた1つの形です。

ongaeshi/ongaeshi-obsidian - GitHub

気に入った部分だけ取り入れてください。「こういう使い方もあるよ」というフィードバックも歓迎します。

デイリーノートの末尾にさっとメモを残せる Obsidian Daily Appender(oda) を作った

はじめに

PCで作業中にふと思いついたことや、どのノートに記録するかをすぐに決められないことは Obsidian のデイリーノートの一番下に## つぶやきという見出しを作って、時刻と一緒に残すようにしています。

1週間に1回程度眺めるだけでも楽しいですし、ここから発展して新しいノートが作られることもよくあります。

## つぶやき
07:00 起きた。 

---
12:55 reading タグの付いた記事を Gemini に翻訳してもらって読んでいくシステムを作る。 

---
12:57 #transrate みたいなタグを付けて翻訳したらタグ外すのがいいか。

---
15:51 折りたたみキーボードこれよさそう。 [MOBO Keyboard 2 | MOBO](https://mobo-jp.com/products/mobo-keyboard2/) #tlog

---
19:43 肩が痛い。

このシステムでしばらく運用していたのですが、何か書きたいことがあるたびに、

  1. Obsidianを開くまたはアクティブにする。
  2. 今日のデイリーノートを開く
  3. 末尾に時刻とメモを残す

というのが、段々と面倒になってきて、そのうちやめてしまいました。それ以降はデイリーノートの1番上に書いたり、毎回新規ノートに書いたり色々と試していたのですがどれもしっくりとしない日々が続きました。

oda (Obsidian Daily Appnder)

ある日 Obsidian CLI の仕様を眺めていると、obsidian daily:append content=CONTENT でデイリーノートの末尾にテキストを挿入できる機能があることを発見しました。これを使えばコマンドラインからデイリーノートにつぶやきするツールが作れそうです。

ソフトウエアの名前について考えてみます。 Obsidian Daily Appnder は正式名としてはよさそうですが、CLI に毎回入力するものとしては長い。頭文字を取ると oda、これはよさそうです。キーボード入力もそこまで難しくない。oda でいくことにしました。

仕様(プロンプト)の記述

obsidianのデイリーノートに連続で複数行入力できるTUIをC#を使って作成したい。

- ソフトウェア名は Obsidian Daily Appender
- コマンド名は oda.exe (Obsidian Daily Appender の略)
- oda で実行するとTUIが起動
- Enterで入力実行。Shift+Enterで複数行入力できる。
- 基本的な入出力の仕様は C:\Users\ongaeshi\Code\obsidian_tool\tweet.rb を参考にせよ。(obsidian CLI を中継して入力する形でOK)

tweet.rb は oda を作る前に Ruby で作ったプロトタイプです。基本的な仕組みや入力文法はここで検証しています。

CLIから複数行入力するのにいくつかのプログラム言語とライブラリを調べていたのですが、不具合なく日本語入力で複数行入力できるライブラリを見つけることができなかったので、使い慣れたC#上で検証してみるとそれなり動く物が作れたので自作することにしました(第一弾としては Windows Terminal 上で動けばOKとする。)。TUIのライブラリとしてはSpectre.Console を使っています。

後は Geimini とキャッチボールします。

oda の完成

最終版はこんな感じになりました。手元で2ファイルです。

ongaeshi/ObsidianDailyAppender (README | Download)

odaを起動してテキストを入力してEnterするとリアルタイムに Obsidian に反映されます。 Shift+Enterで複数行入力が可能です。履歴は Alt+↑↓

今まで思い付いたことをObsidianに書こうとしたときに、Obsidianを探したりノートを探すのに手間取る認知負荷が無駄に高かったのですが、このツールのおかげで大分楽になりました。似たようなことをモバイル上でもやっているのですがそれはまたそのうちに。