ImmiChange

App
ImmiChange Icon

ImmiChange

Auto Wallpaper.

Welcome

Thank you for accessing ImmiChange.

This app was developed with a simple goal: “To replicate the seamless, automatic wallpaper and lock screen switching of iOS on Android.” We want to bring that delightful experience—where you discover a new favorite memory every time you unlock your phone—to the Android community.

Originally, we aimed for direct integration with the Google Photos API, but due to its strict limitations, we changed course. Instead, we implemented “Local Mode.” This allows users to manually pick photos from Google Photos (or any gallery app) and enjoy the same automatic switching experience, even without an Immich server.

Getting Started (Setup Wizard)

When you first open the app, we ask for a few essential permissions to ensure everything runs smoothly.

Permissions & Initial Setup

  • Notifications: To keep you informed about wallpaper updates or server connection issues.
  • Battery Optimization: To prevent Android from closing the app, allowing it to update wallpapers in the background.
  • Home Wi-Fi (SSID) Setup: Used to restrict Immich server syncing to when you are at home, ensuring zero data usage while on the go.

Immich Server Setup

To use Immich mode, you’ll need the following. (※If you only plan to use Local Photo mode, you can skip this step.)

  • Server URL: The address of your Immich instance (e.g., http://your-ip:2283).
  • API Key: A secure key to read your albums and photos.
【Required API Scopes】
Ensure your Immich API key has these 5 scopes enabled:
・album.read
・asset.read
・asset.view
・asset.download
・server.about

How to Use the App

Select your preferred source from the Dashboard on the home screen.

Immich (Server) Mode

  • Wi-Fi Synchronization: To save mobile data, new photos are only downloaded when you are connected to your designated Home Wi-Fi.
  • Cache Management: The app maintains a rotation of photos within your specified cache limit (MB).
【Tips: Sync Issues】
If connecting to the server fails, the app uses an “Exponential Backoff” strategy, retrying in increasing intervals.

Local Mode

  • Stability via Copying: Selected photos are copied to a permanent app storage area. This ensures your wallpaper remains set even if the original file is deleted.
  • Photo Manager: Manage your collection in the “Manager” view. Long-press photos to enter selection mode for bulk deletion.
Storage Note: Since photos are copied internally, adding many images will consume device storage.

Settings Explained

  • Update Interval: Choose between “On Screen Off” (Recommended) or fixed intervals (minutes, hours, or days).
  • Compression: 75% is usually the “sweet spot” for great looks and low storage usage.
  • Stroke Intensity: For Live Wallpapers, this adjusts how much the photo moves when you swipe.
PRO

Pro Mode (The Ultimate Personalization)

Upgrading to Pro transforms your smartphone into a unique, premium gallery experience.

  • Live Wallpaper Engine (Fluid Engine): Powering your home screen with 120FPS hardware acceleration. Photos smoothly follow your finger as you swipe.
  • Advanced Date Positioning: Move the shooting date to any coordinate on your screen with 0-100% precision.
  • Intelligent Contrast Detection: The app samples the background to automatically toggle between black and white text.
  • Material You (Monet) Sync: System accents and app UI are automatically theme-matched to your current wallpaper.
  • Seamless Auto-Switching: Live Wallpapers rotate automatically based on screen-off events or time intervals.
  • Multi-Album Support: Select and mix multiple Immich albums at once.

Our Philosophy

  • Smooth at 120FPS: We use high-speed hardware rendering to provide buttery-smooth transitions with minimal battery impact.
  • Privacy First: Your API keys and photos never leave your device. We value your trust.

はじめに

ImmiChangeにアクセスしていただき、ありがとうございます。

このアプリは、「iOSの標準機能にあるような、ロック画面や壁紙の自動切り替えをAndroidでも実現したい」という想いから開発されました。スマホを開くたびに新しいお気に入りの写真に出会える、あの心地よい体験をAndroidユーザーの皆様にお届けすることを目指しています。

当初はGoogleフォトとの直接連携を目指しましたが、APIの厳しい制限により断念しました。しかし、その代わりに「Localモード」を実装することで、独自のImmichサーバーをお持ちでない方でも、Googleフォトから手動で選んだ写真を使って同様の体験を楽しめるように工夫しています。

初期設定(セットアップ・ウィザード)

アプリを初めて起動すると、いくつかの設定をお願いしています。

権限と初期設定を求める理由

  • 通知権限: 壁紙の更新状況や、サーバーとの同期エラーをお知らせするために使用します。
  • バッテリー消費の最適化解除: Androidのシステムによってアプリが強制終了されるのを防ぎ、バックグラウンドで壁紙を更新し続けるために必要です。
  • 自宅Wi-Fi (SSID) の設定: Immichサーバーとの同期を「自宅にいる時だけ」に限定し、パケット消費をゼロにするために使用します。

Immichサーバー設定

Immichモードを使用する場合、以下の設定が必要です。(※ローカル写真モードのみを使用する場合は、設定せずにスキップ可能です)

  • Server URL: あなたのImmichインスタンスのURL
  • API Key: サーバーから安全に写真を読み込むための鍵です。
【必要な権限詳細】
ImmichのAPIキーには、以下の5つのスコープが含まれている必要があります:
・album.read
・asset.read
・asset.view
・asset.download
・server.about

アプリの使い方(各モード解説)

ホーム画面にある「Dashboard」から、好みのモードを選択できます。

Immich (サーバー) モード

  • 自宅Wi-Fiでの更新: 外出先でのパケット消費を抑えるため、指定した自宅Wi-Fi接続時のみ同期します。
  • キャッシュ管理: 指定した容量の範囲で、写真を賢く入れ替えます。

Local (ローカル) モード

  • 安定性のためのコピー: 選択された写真はアプリ専用領域にコピーされるため、元のファイルを削除しても壁紙は維持されます。
  • Photo Manager: 取り込んだ写真は一覧から一括削除などの管理が可能です。

設定項目の名称と意味

  • 切り替えタイミング (Update Interval): 画面OFF時、または指定時間間隔での切り替えが可能です。
  • 圧縮率 (Compression): 画質と容量のバランスを調整します。75%程度が推奨です。
PRO

Proモード(究極のパーソナライズ)

  • ライブ壁紙エンジン (Fluid Engine): 120FPS対応の独自エンジン。スワイプに合わせて写真が滑らかに追従します。
  • 高度な日付表示設定: 撮影日時の表示位置を0〜100%で自在に配置。リアルタイムプレビュー可能です。
  • Monet (Material You) 完全同期: 壁紙の色に合わせてシステム全体のUIカラーを自動生成します。

設計のこだわり

  • 120FPS対応: 高速ハードウェア描画により、最高の滑らかさを追求しています。
  • プライバシー保護: 取得データは端末内のみに保存され、外部に送信されることはありません。

コメント

タイトルとURLをコピーしました