overkami: オーバーレイ壁紙アプリ

このアプリは、特定のアプリに壁紙を設定するための、tauri製の実験的なアプリです。

仕組み上、どんなアプリでも基本的には壁紙を再現できます。 ただ、このアプリはベータ段階で、なおかつ、壁紙の表示方法がトリッキーで不安定です。 このため、このアプリを使って起きたあらゆる損害を開発者は一切、負いません。

なお、このプロジェクトのオーナーは、このプロジェクトを実験的段階以降に引き上げる予定はありません。 このため、これからサポートが継続される保証がないです。 ですが、Pull Requestは歓迎しますし、このリポジトリの運用を引き継いでくれる人がいれば譲渡します。 （場合によってはこの方針が変わる可能性もあります。）

仕組み

半透明でタイトルバーを持たない、クリックが貫通するウィンドウをまず作ります。 そしてこのウィンドウに壁紙を写し、壁紙を設定したいアプリのウィンドウにサイズを合わせ追従させます。 これにより、壁紙表現を擬似的に再現します。

ウィンドウを追従させるのは、WindowsではSetWinEventHook、macOSではAXObserverCreateを使うことで実現しています。 これらは、ウィンドウの動きを監視するのに使い、ウィンドウが動いた際に通知を受け取ることができます。 それにより、ウィンドウが動いた際に壁紙ウィンドウも同じ場所に追従して動かせるわけです。

技術スタック

• GUIフレームワーク: tauri
• フロントエンド
  • TypeScript
  • SolidJS
  • Tailwind CSS
  • Tailwind Variants
  • Modular Forms: フォームバリデーション

対応プラットフォーム

• Windows
• macOS
• Linux系OS

Linux系OSに対応する予定はないですが、Pull Requestは歓迎します。

スクリーンショット

2025-11-04.16.16.03.mov

セットアップ方法

このプロジェクトでは、JavaScriptランタイムのBunとRustパッケージマネージャcargoが必要です。

セットアップをするにはまず、以下のコマンドでフロントエンドの依存関係をインストールします。

$ bun install --no-save

次に、以下のtauriコマンドでビルドを行います。

$ bun tauri build

すると、Macであればsrc-tauri/target/release/bundleに、Windowsであればsrc-tauri/release/bundle/nsisにバンドルがあります。 開発のための、ホットリロード機能付きのビルドはbun tauri devで動かせます。

ライセンス

このプロジェクト・アプリは、GNU General Public License v3.0 or laterに基づいて提供されます。