Obsidian プラグイン
Obsidian 用 Aktar
ノートは軽いまま、添付ファイルは自分の S3、Cloudflare R2、Backblaze B2、DigitalOcean Spaces、MinIO バケットに。ファイルを貼り付けるかドロップすればバケットに送られ、すでにある添付ファイルも移動できます。リンクはすべてふつうの https:// URL なので、プラグインがあってもなくても使えます。
無料でオープンソース。デスクトップ、iPhone、iPad、Android に対応し、Obsidian 1.11.4 以降で使えます。
ふつうのリンクで、囲い込みなし
Aktar は埋め込みを、バケットの URL を使った標準の Markdown 画像に書き換えます。サイズもキャプションもそのままで、ノートの見た目も変わりません。
![[IMG_2041.png|300]]- ノートは数キロバイトのまま、Obsidian Sync、iCloud、Git など、いまと同じ方法で同期されます。
- リンクはどの Markdown アプリでも、GitHub でも、ブラウザでも、プラグインのない Obsidian でも使えます。プラグインをアンインストールしても何も壊れません。
- いつでも元に戻せます。Bring files back でファイルを保管庫にダウンロードし、リンクをふつうの添付ファイルのリンクに戻します。
できること
プラグインは Aktar アプリと同じアップロード先、パスのテンプレート、ルールを使います。Obsidian からアップロードしたファイルは、Mac やスマートフォンからアップロードしたときと同じ場所に入ります。
-
貼り付けとドロップ
貼り付けたりドロップしたりしたファイルは、すぐにプレースホルダーとしてノートに入り、アップロードが終わるとリンクになります。貼り付けやドロップのときにバケットへ送るもの(画像、すべてのファイル、なし)を選べ、新しく埋め込む画像の既定の幅も設定できます。
-
既存の添付ファイルを移動
1つのノート、または保管庫全体の添付ファイルを移動します。実行前のドライランで、変わるファイルとノートをすべて一覧にします。フロントマター、コードブロック、キャンバスにあるリンクとそのファイルには手を付けません。ローカルのコピーはゴミ箱に入れるか、そのまま残せます。
-
どの移動も取り消せる
Undo the last move to the bucket で、ファイルを保管庫にダウンロードし直し、すべてのリンクを元に戻します。
-
ファイルを戻す
ノートのファイルをバケットから保管庫にダウンロードします。リンクはふつうの添付ファイルのリンクになり、Obsidian のリンク設定(ウィキリンクか Markdown か、最短パスか相対パスか)どおりに書かれます。
-
新しい添付ファイルを自動で移動
スマートフォンで添付した写真や、ほかのプラグインが保管庫に保存したファイルは、ノートに埋め込まれた時点でバケットに移動します。どのノートからもリンクされていないファイルはそのままです。対象を1つのフォルダに絞ることもできます。
-
非公開のバケット
ノートにはふつうのリンクが残り、プラグインはデバイス上で署名した1時間有効な URL でファイルを表示します。キーを持っていない人は開けません。
-
ライブラリ
3つのビューを持つサイドパネルです。ノートが使っているバケットのファイルとその場所、バケットのフォルダとファイル、アップロードのキューを表示します。どのノートからもリンクされなくなったファイルを見つけ、確認のうえでまとめて削除できます。
-
リンクの操作
リンクを右クリックすると、コピー、1時間・1日・7日間有効なリンクのコピー、開く、ファイルを保管庫に戻す、バケットから削除ができます。削除の前には、そのファイルにリンクしているノートを教えてくれます。
-
写真を小さく
アップロード前に写真を WebP に変換できます。同じ画質で JPEG の約3分の1のサイズです。3840、2560、1920、1280、1024 ピクセルに縮小することもできます。GIF と SVG はそのままです。WebP を作れないデバイス(iPhone、iPad)では JPEG になります。
-
写真に位置情報を残さない
撮影場所の情報は、写真がデバイスを離れる前に削除されます。画像そのものは変わりません。
-
オフラインでも使える
一度表示した画像は、指定した容量までデバイスに保存されるので、接続がなくてもノートに表示されます。アップロードはキューで待機し、オフラインになっても Obsidian を再起動しても消えず、接続が戻ると自動で送られます。
-
Aktar アプリと連携
Aktar を入れた Mac や PC では、ワンクリックでプラグインとアプリを接続できます。アップロードは Aktar を通り、Aktar のアップロード先、キー、履歴、フックが使われます。Obsidian がキーを目にすることはありません。
-
ノートを公開
ノートを画像ごと自分のバケットの Web ページにして、そのリンクをコピーします。リンクは無期限か7日間有効かを選べます(非公開のバケットでは常に7日間)。ページはスクリプトを実行できず、Take down で取り下げられます。
-
保管庫のバックアップ
保管庫全体の zip を毎日または毎週、推測できない名前でバケットに送り、新しいものから3、7、14、30個を残します。いちばん長く起動しているデバイス1台でオンにしてください。ほかのプラグインがパスワードを保存していることがあるため、Obsidian の設定フォルダは含めると指定しない限り除外されます。
-
自分のフォルダ構成
既定では、保管庫ごとにバケット内に専用のフォルダ
obsidian/{vault}/{year}/{month}/{short}.{ext}ができます。ノートの名前やフォルダ、日付、元のファイル名、短いコードを使えます。移動したファイルにはファイルだけで決まる名前が付くので、同期している2台のデバイスが同じファイルを移動しても、同じオブジェクトと同じリンクになります。 -
すべてのデバイスで
同じプラグインが Mac、Windows、Linux と、iPhone、iPad、Android の Obsidian で動きます。アップロード先は保管庫と一緒に同期されますが、キーは同期されず、各デバイスが転送コードで一度だけ受け取ります。
セットアップ
Obsidian のコミュニティプラグイン(Settings › Community plugins › Browse)から Aktar をインストールして有効にします。次に、3つの方法のどれかでアップロード先を追加します。
Aktar アプリから
- Mac、PC、iPhone、Android の Aktar でアップロード先を開き、別のデバイスに転送を選びます。転送リンクをコピーします。
- Obsidian で Settings › Aktar › Add from Aktar app を開きます。リンクはクリップボードから入力されます。
- Aktar に表示される12文字のコードを入力します。キーは暗号化されたまま届き、アップロード先の準備ができます。
このコンピュータの Aktar と接続
- Mac 版 Aktar 0.19 以降または Windows 版 0.12 以降をインストールし、そこでアップロード先を追加します。
- Obsidian で Settings › Aktar › Aktar app を開き、Connect をクリックします。
- Aktar に表示されるダイアログで Connect をクリックします。Aktar のアップロード先がプラグインに表示され、アップロードはアプリを通るようになります。
手動で入力
- Settings › Aktar で Add manually を選びます。
- エンドポイント、バケット、リージョン、公開 URL、キーを入力します。プロバイダごとの確認場所はセットアップガイドにあります。
- 接続をテストして保存します。
コマンド
すべての操作はコマンドパレットにあるので、Settings › Hotkeys でホットキーを割り当てられます。よく使うものはエディタの右クリックメニューにもあります。
- Upload a file into this note
- ファイルを選んでアップロードし、ノートのカーソル位置に入れます。
- Move this note’s attachments to the bucket
- ドライランのあと、開いているノートの添付ファイルを移動します。
- Move attachments to the bucket…
- ドライランのあと、保管庫全体またはフォルダの添付ファイルを移動します。
- Bring this note’s files back into the vault
- 開いているノートのバケットのファイルを保管庫にダウンロードし、リンクを添付ファイルのリンクにします。
- Undo the last move to the bucket
- 直前の移動を元に戻します。ファイルが戻り、リンクも元どおりになります。
- Open the library
- サイドパネルにライブラリを開きます。
- Publish this note as a web page
- 開いているノートを自分のバケットの Web ページにし、そのリンクをコピーします。
- Take down this note’s web page
- 開いているノートの Web ページをバケットから削除します。
- Back up the vault now
- スケジュールに関係なく、いますぐ保管庫を zip にしてバケットに送ります。
- Retry uploads
- 待機中のアップロードをもう一度試します。
- Save failed uploads into the vault instead
- 失敗し続けるアップロードを保管庫に保存し、何も失われないようにします。
- Add a destination from an Aktar app
- 転送リンクとコードからアップロード先を追加します。
キーはデバイスから出ません
アップロード先はプラグインの設定に保存され、保管庫と一緒に同期されます。キーがそこに入ることはありません。キーは各デバイスの Obsidian のシークレットストレージに保管され、同期されないので、共有する保管庫や Git に置いた保管庫にもキーは含まれません。
アップロード先はあるのにキーがないデバイスは、そのことを知らせて転送コードを求めます。Aktar アプリと接続していれば、Obsidian がキーを目にすることはまったくありません。
接続する先
追加したアップロード先のストレージのエンドポイントと公開 URL だけです。デスクトップで Aktar アプリと接続している場合は 127.0.0.1 の Aktar アプリにも接続します。間に Aktar のサーバーはなく、アカウントも分析もテレメトリもありません。
どのノートがどのファイルにリンクしているかを知るために保管庫のファイルを一覧にしますが、バケットに送られるのはアップロード、移動、バックアップしたファイルだけです。クリップボードを読むのは、転送リンクを入力するために Add from Aktar app を開いたときの1回だけです。
動作環境
- Mac、Windows、Linux、iPhone、iPad、Android の Obsidian 1.11.4 以降
- Amazon S3、Cloudflare R2、Backblaze B2、DigitalOcean Spaces、MinIO、その他の S3 互換サービスのバケット(公開 URL ありでも非公開でも可)
- オプション: ワンクリックで接続するための Mac 版 Aktar 0.19 以降または Windows 版 0.12 以降
よくある質問
プラグインがなくてもノートは使えますか?
はい。リンクはすべてバケットを指すふつうの Markdown リンクなので、どの Markdown アプリでも、Web でも、Aktar のない Obsidian でも画像が表示されます。プラグインが必要なのは非公開のバケットにあるファイルだけです。署名付き URL が必要になるためです。
保管庫のファイルはどうなりますか?
移動すると、ローカルのコピーは Obsidian のゴミ箱に入ります。Keep it in the vault too を選べばそのまま残ります。どのノートからもリンクされていないファイルや、フロントマター、コード、キャンバスからリンクされているファイルはそのままです。
元に戻せますか?
はい。直前の移動を取り消すことも、1つのノートのファイルを戻すことも、リンクのメニューから1つずつ戻すこともできます。ファイルはバケットからダウンロードされ、リンクはふつうの添付ファイルのリンクに戻ります。
Obsidian Sync、iCloud、Git と一緒に使えますか?
はい。同期を置き換えるのではなく、同期するものを小さくします。同じファイルを移動した2台のデバイスは同じオブジェクトと同じリンクを書くので、競合しません。
料金はかかりますか?
プラグインは無料でオープンソースです。保存した分の料金をストレージのプロバイダに支払います。Cloudflare R2 ならダウンロードは無料です。