KizunaShelfの紹介:愛するすべてを収めるためのシェルフ
Introduction to KizunaShelf: A shelf for everything you love (mudkip.me)
要約
KizunaShelfは、書籍、映画、音楽など、人生に影響を与えたあらゆるものを記録・管理するためのツールです。Markdownファイルとフロントマターを基本とし、Obsidianなどのエディタと連携します。柔軟なスキーマ定義と豊富なメタデータプロバイダー連携により、ユーザーは自分だけのデータベースを構築できます。
全文翻訳
KizunaShelfの紹介:愛するすべてを収めるためのシェルフ
[画像]
[画像]
誰もが、本、映画、テレビ番組、アニメ、あるいは曲など、人生に影響を与えたものを記録する方法を持っています。時には巨大なカタログを持つオンラインサービスを利用することもありますが、プラットフォームが何を残し、何を取り除くかを決定することに常に左右されます。また、魅力的でよくデザインされたオフラインのモバイルアプリもありますが、多様な興味は単一の定義済みカタログやデータモデルに収まることは稀です。さらに、それらのアプリやサービスは明日消えてしまう可能性もあります。
数え切れないほどのツールを試した後、私は本当に自分でコントロールできるものが欲しいと気づきました。Airtableでカスタムデータベースの構築を始め、次にNotionに移り、最終的にはNocoDBのセルフホスティングを試しました。結局、データベースを絶えず移行するのではなく、ファイル中心のアプローチの哲学を採用することにしました。Obsidian Vaultに落ち着き、そこで私が大切にしているすべてがMarkdownファイルとなり、フロントマターを備え、Dataview、そして後にObsidian Basesで整理されるようになりました。
しかし、2,000以上のMarkdownファイルを扱うデータベースを手動で管理することは、新たな種類の摩擦を生み出しました。メタデータを探し出し、ステータスを更新し、日付を追跡することです。司書のように振る舞うという退屈な作業が、次に楽しむものを発見する本来の喜びを奪ってしまいました。
KizunaShelfは、これらすべてに対する答えです。
デザイン哲学
私が常に心に留めている原則の一つは、KizunaShelfは単なるメディアトラッカーではないということです。むしろ、Airtableのようなデータベースの動的な柔軟性をもたらし、ユーザーが自分のデータの意味を正確に定義できるようにします。スキーマは、検査および変更可能であり、意味の真実の情報源として機能します。
Vaultフォルダに保存された単一の KizunaShelf/config.yaml ファイルが、タイプ、そのフィールド、および各フィールドの特定の役割を宣言します。これは以下を定義します:
- どのフィールドがアイテムのタイトルを表し、そのタイトルがどの言語であるか。
- どのフィールドが日付を表し、その日付が何を表すか(例:ゲームのリリース日、アニメを見始めたとき、または特定のイベントが発生したとき)。
- どのフィールドがステータスを表し、そのカスタムオプションリストとともに。
- オブジェクトが互いにどのように関連し、異なるタイプをどのように接続するか。
しかし、スキーマの複雑さに気後れする必要はありません。KizunaShelfは、従来のメディアトラッカーに期待されるすべてのデフォルトプリセットを標準で提供します。アニメ、テレビ&ドラマ、映画、ゲーム、ボードゲーム、書籍、マンガ&コミック、音楽アルバム、ポッドキャスト、アーティスト&クリエイター、キャラクターなどの事前定義されたプリセットからすぐに選択できます。
これらのタイプは、TMDB、TheTVDB、IGDB、Bangumi、Apple Music、MyAnimeList、Google Booksなど、あなたがすでに知っている外部メタデータプロバイダーに直接接続することもできます。
KizunaShelfにアイテムを追加するのは非常に迅速かつ簡単です。プラスボタンをタップし、探しているものを検索して、タップして追加するだけです。カバーはローカルにダウンロードでき、ステータスと日付は自分のペースで後で記録できます。KizunaShelfは、「サブアイテム」の概念も理解しており、アニメのエピソードやCDのトラックリストなどを、同じMarkdownファイル内でチェックリストまたは箇条書きリストとして個別に追跡できます。
エンジニアリングアーキテクチャ
[画像]
内部では、これは興味深いエンジニアリング実験でした。
このプロジェクトには、非常に具体的で野心的なチェックリストがありました:
- どこからでもアクセスできるセルフホスト型のWebアプリ。
- macOS、Linux、Windowsで動作する軽量なデスクトップアプリ。Obsidianと全く同じローカルフォルダを開きます。
- 真のモバイルアプリ。魅力的で、素早く、私の電話にネイティブなものです。
デスクトップアプリの答えはTauriでした。しかし、モバイルの解決は「もし~だったら?」という瞬間につながりました:もしRustコアをUniFFI経由でSwiftモジュールに直接ブリッジし、その周りにネイティブなSwiftUIアプリを書いたらどうなるだろうか?
これは別の課題を引き起こしました:実質的に「2.5クライアント」(TauriデスクトップアプリはWebアプリとほぼすべてのフロントエンドコードを共有するため)間で、Rustコアを完全に整合させるにはどうすればよいか?
私の解決策は、Rustバックエンドから直接OpenAPI(Swagger)仕様を生成し、その仕様を使用してTypeScriptとSwiftクライアントを自動生成することでした。
その結果、真にクロスプラットフォームなアーキテクチャが生まれました。iOSアプリは完全にネイティブなSwiftUIであり、デスクトップアプリはElectronの重さを回避しています。将来のAndroidアプリも、この全く同じアーキテクチャに従い、他のクライアントと機能を一致させながら、プラットフォームに完全にネイティブであり続けることができます。
アプリ構築中に遭遇した一つのつまずきは、異なるプラットフォームでのUnicode NFC対NFD正規化でした。これは解決され、ファイル名でPokémonまたはポケモンを使用しても安全です。ウィキリンクと関連マッチングは、NFC/NFDの違いを超えて正規化されています。
kizuna(絆):つながり続けるもの同士の結びつき
[画像]
[画像]
多くのアニメシリーズ、ビデオゲーム、あるいはこのアプリの名前にインスピレーションを与えた音楽プロジェクトなど、多くの作品が私にとって世界そのものです。それらは記憶される価値があり、私たちの人生の特定の瞬間と結びつけられるに値します。KizunaShelfは、まさにそれらのつながりをマッピングするように設計されています。カレンダーは、あなたが気にかけているものを言及する今後のリリース、計画、および日々のジャーナルエントリを追跡します。一方、アクティビティフィードは、これらの瞬間を視聴、プレイ、読書したことのタイムラインにキュレーションし、それらがいつあなたの人生の一部になったかを正確に記録します。
アイテム間のつながりはKizunaShelfの中心です。フロントマターの関係、ウィキリンク、バックリンク、リストを単一の詳細なビューに集めることで、アプリはすべてを1か所にまとめます:お気に入りのアニメキャラクター、その声優、あなたが参加した実際のイベント、そして棚に置かれているフィギュア。
2017年5月上旬のある日、秋葉原のレトロゲーム店に入り、Ever17を含むPSPゲームのバンドルを購入しました。そのまさにその瞬間、LeMUの出来事がリアルタイムで展開されていました。その記憶は、このアプリが存在する理由である、まさにそのような絆なのです。
永遠に、夢のために
私はこのアプリを数ヶ月かけて構築し、数週間かけて自分で使用してきました。KizunaShelfのiOS版が現在TestFlightでベータテストのために利用可能であり、オープンソースのデスクトップ版とセルフホスト型Web版はまもなく公開されます。Android版は今年後半か来年に予定されています。私は当面このアプリを維持することにコミットしています。
しかし、すべてのアプリはいずれ消えていきます。KizunaShelfは、それ自身の寿命を念頭に置いて設計されています。このアプリにはデータを保存するサーバーも、独自のフォーマットもありません。KizunaShelfに保存されているすべては、人間が読めるフロントマターを少し加えたプレーンなMarkdownです。既存のエコシステムとよく連携するように、いくつかのトリックも使用しました。アニメやテレビ番組のエピソードには、放送日のための📅があり、そのエピソードをチェックすると✅の日付が追加されます。これはObsidian Tasksでどのように表現されているかに従っています。スマートリストはObsidian Basesフォーマットのサブセットを使用しているため、Obsidianで開いて全く同じアイテムを表示できます。
あなたのデータは、このアプリがあってもなくても、永遠にあなたと共にあります。