{"id":48371999,"url":"https://github.com/teamnocturnal/androidtoolkit","last_synced_at":"2026-05-23T10:06:57.166Z","repository":{"id":349172556,"uuid":"1198921054","full_name":"TeamNocturnal/AndroidToolkit","owner":"TeamNocturnal","description":"Power-user Android, Quest, and TV device toolkit for ADB management, sideloading, backups, debloating, cleanup, and system tools.","archived":false,"fork":false,"pushed_at":"2026-04-05T15:30:31.000Z","size":28535,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-05T17:29:01.669Z","etag":null,"topics":["adb","android","android-tv","backup-utility","debloat","fire-tv","quest","restore-utility","sideloading","toolkit"],"latest_commit_sha":null,"homepage":"https://team-nocturnal.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TeamNocturnal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-01T22:21:46.000Z","updated_at":"2026-04-05T15:20:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TeamNocturnal/AndroidToolkit","commit_stats":null,"previous_names":["teamnocturnal/androidtoolkit"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/TeamNocturnal/AndroidToolkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamNocturnal%2FAndroidToolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamNocturnal%2FAndroidToolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamNocturnal%2FAndroidToolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamNocturnal%2FAndroidToolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TeamNocturnal","download_url":"https://codeload.github.com/TeamNocturnal/AndroidToolkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeamNocturnal%2FAndroidToolkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31779947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adb","android","android-tv","backup-utility","debloat","fire-tv","quest","restore-utility","sideloading","toolkit"],"created_at":"2026-04-05T17:01:34.638Z","updated_at":"2026-04-14T03:00:57.540Z","avatar_url":"https://github.com/TeamNocturnal.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./docs/assets/team-nocturnal-logo.png\" alt=\"Team Nocturnal\" width=\"280\" /\u003e\n\n# Android Toolkit by Team Nocturnal\n\n### A cleaner control center for sideloading, ADB, Fastboot, TV streaming tools, Quest workflows, backups, and Android power-user tasks.\n\n[Official Site](https://toolkit.team-nocturnal.com) • [Forum Thread](https://forums.wbodytech.com/%E2%9A%A1-nocturnal-toolkit-by-team-nocturnal.t239/) • [Changelog](./CHANGELOG.md) • [All Releases](https://github.com/TeamNocturnal/AndroidToolkit/releases)\n\n`macOS` `Windows` `Linux` `Android` `Tauri 2` `Rust` `React` `Vite`\n\n\u003c/div\u003e\n\n\u003e Android Toolkit started as a simpler install-and-ADB helper, but it has grown into a full desktop and Android management suite for phones, tablets, TVs, Quest headsets, sideloading, backups, wireless debugging, maintenance, and recovery work.\n\n## Visual Snapshot\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/getting-started-dark.png\" alt=\"Android Toolkit getting started screen\" width=\"47%\" /\u003e\n  \u003cimg src=\"./docs/assets/devices-dark.png\" alt=\"Android Toolkit devices screen\" width=\"47%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/tv-streaming-dark.png\" alt=\"Android Toolkit TV and streaming tools\" width=\"47%\" /\u003e\n  \u003cimg src=\"./docs/assets/manage-apps-dark.png\" alt=\"Android Toolkit manage apps screen\" width=\"47%\" /\u003e\n\u003c/p\u003e\n\n| Brand | Mood | Focus |\n| --- | --- | --- |\n| Dark glass styling, Team Nocturnal branding, and a desktop-first layout modeled after the website. | Built to feel more like a polished toolkit dashboard than a generic utility wrapper. | Device setup, TV tools, app management, and power-user Android workflows in one visual surface. |\n\n## Quick Start\n\n| Track | Link | Use It For |\n| --- | --- | --- |\n| Stable | [Latest stable release](https://github.com/TeamNocturnal/AndroidToolkit/releases/latest) | Normal installs and public release builds |\n| Nightly | [Nightly and preview releases](https://github.com/TeamNocturnal/AndroidToolkit/releases) | Latest fixes, newest tooling, and in-progress features |\n\n## Why It Pops\n\n| Area | What You Get |\n| --- | --- |\n| Device Control | USB + wireless ADB, pairing flows, saved devices, transport details, recovery shortcuts |\n| Apps \u0026 Stores | APK queue installs, split package handling, app stores, package tools, app management |\n| TV \u0026 Streaming | Fire TV, Android TV, Google TV, Shield, ONN, launcher tools, guided setup, media installs |\n| Power Tools | File browser, backups, cleanup, diagnostics, tweaks, ROM tools, shell access |\n| Quest | Quest-focused sideloading and headset setup flows |\n| Android App | Mobile-first toolkit flow with local shell, logcat, install, and maintenance tools |\n\n## Experience\n\n| Look | Workflow | Audience |\n| --- | --- | --- |\n| Dark, branded, TV-friendly, and desktop-focused | Install, connect, sideload, manage, tweak, back up, and recover from one place | Power users, streamers, Android TV users, Quest users, and anyone tired of juggling shell commands |\n\n## Install Android Toolkit\n\n### macOS\n\n| Download | Install |\n| --- | --- |\n| Grab the `.dmg` that matches your Mac: `aarch64` / `arm64` for Apple Silicon, `x86_64` for Intel. | 1. Download the `.dmg`  2. Open it  3. Drag `Android Toolkit.app` into `Applications`  4. Launch it from `Applications` |\n\n\u003e macOS note: builds are ad-hoc signed and not notarized yet. If Gatekeeper blocks the DMG or app, open `System Settings` -\u003e `Privacy \u0026 Security` -\u003e `Open Anyway`, then launch again. You may need to approve the DMG once and the app once.\n\n### Windows\n\n| Download | Install |\n| --- | --- |\n| Use either the `.exe` installer or the `.msi` package from the release page. | 1. Download the Windows asset  2. Run the `.exe` or open the `.msi`  3. Follow setup prompts  4. Launch `Android Toolkit` from Start or the desktop shortcut |\n\n\u003e Windows note: if SmartScreen warns on first launch, click `More info`, then `Run anyway`.\n\n### Linux\n\n| Distro Family | Preferred Package |\n| --- | --- |\n| Debian / Ubuntu / Linux Mint / Pop!_OS / KDE Neon | `.deb` |\n| Fedora / openSUSE | `.rpm` |\n| Arch Linux / EndeavourOS / Manjaro | `AppImage` |\n\nNightly Linux releases use filenames like:\n\n- `Android-Toolkit_2.0.3_nightly-YYYYMMDD-HHMMSS_amd64.deb`\n- `Android-Toolkit_2.0.3_nightly-YYYYMMDD-HHMMSS_amd64.AppImage`\n- `Android-Toolkit_2.0.3_nightly-YYYYMMDD-HHMMSS_x86_64.rpm`\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDebian / Ubuntu / Linux Mint / Pop!_OS / Zorin / KDE Neon\u003c/strong\u003e\u003c/summary\u003e\n\nOption 1: install from `Downloads`.\n\n```bash\ncd ~/Downloads\nsudo apt update\nsudo apt install ./Android-Toolkit_\u003cversion\u003e_amd64.deb\n```\n\nOption 2: type the command, then drag the `.deb` file into Terminal so your desktop pastes the exact path.\n\n```bash\nsudo apt install \n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eFedora\u003c/strong\u003e\u003c/summary\u003e\n\nOption 1: install from `Downloads`.\n\n```bash\ncd ~/Downloads\nsudo dnf install ./Android-Toolkit-\u003cversion\u003e-1.x86_64.rpm\n```\n\nOption 2: type the command, then drag the `.rpm` file into Terminal.\n\n```bash\nsudo dnf install \n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eopenSUSE\u003c/strong\u003e\u003c/summary\u003e\n\nOption 1: install from `Downloads`.\n\n```bash\ncd ~/Downloads\nsudo zypper install ./Android-Toolkit-\u003cversion\u003e-1.x86_64.rpm\n```\n\nOption 2: type the command, then drag the `.rpm` file into Terminal.\n\n```bash\nsudo zypper install \n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eArch Linux / EndeavourOS / Manjaro\u003c/strong\u003e\u003c/summary\u003e\n\nOption 1: launch it from `Downloads`.\n\n```bash\ncd ~/Downloads\nchmod +x Android-Toolkit-*.AppImage\n./Android-Toolkit-*.AppImage\n```\n\nOption 2: type each command first, then drag the AppImage into Terminal so it pastes the full path.\n\n```bash\nchmod +x \n./\n```\n\nIf you are on Wayland with NVIDIA and an older nightly aborts before the window opens, retry it once with:\n\n```bash\nWEBKIT_DISABLE_DMABUF_RENDERER=1 ./\n```\n\n\u003c/details\u003e\n\n\u003e Linux notes:\n\u003e - If your app menu does not refresh after install, sign out and back in once or restart the desktop shell/session.\n\u003e - Linux packages and launchers are bundled under the `Utility` category so they land in a normal Utilities-style menu section instead of `Lost \u0026 Found`.\n\n## Toolkit At A Glance\n\n| Section | Highlights |\n| --- | --- |\n| Apps | `Install APK`, split package support, APK search, app stores, app management |\n| Devices | USB + wireless ADB, pairing, saved devices, battery and storage details |\n| Media | TV and streaming setup, launcher tools, media app installs, device-specific flows |\n| Power Tools | File browser, backups, cleanup, diagnostics, tweaks, ROM tools |\n| Pro Tools | `ADB \u0026 Shell`, reboot modes, quick commands, package and permission controls |\n| Android App | Local shell, logcat, installs, maintenance, and Android-specific UX |\n\n## Tech Stack\n\n| Layer | Stack |\n| --- | --- |\n| App Shell | `Tauri 2` |\n| Frontend | `JavaScript`, `React`, `Vite` |\n| Native Layer | `Rust` |\n| Device Tools | Bundled `adb` and `fastboot` binaries |\n\n## Project Links\n\n- Official site: [toolkit.team-nocturnal.com](http://toolkit.team-nocturnal.com)\n- Changelog: [CHANGELOG.md](./CHANGELOG.md)\n- Stable download: [releases/latest](https://github.com/TeamNocturnal/AndroidToolkit/releases/latest)\n- Nightly builds: [releases](https://github.com/TeamNocturnal/AndroidToolkit/releases)\n\n## macOS Setup\n\n### Requirements\n\n- `Node.js` + `npm`\n- `Rust`\n- `Xcode Command Line Tools`\n\nOfficial links:\n\n- Node.js: [https://nodejs.org](https://nodejs.org)\n- Rust / rustup: [https://rustup.rs](https://rustup.rs)\n- Xcode Command Line Tools: [https://developer.apple.com/xcode/resources/](https://developer.apple.com/xcode/resources/)\n\nInstall the common prerequisites:\n\n```bash\nxcode-select --install\nbrew install node\ncurl https://sh.rustup.rs -sSf | sh\n```\n\nRestart your terminal after installing Rust, or run:\n\n```bash\nsource \"$HOME/.cargo/env\"\n```\n\n### Run In Dev Mode\n\n```bash\nnpm run tauri dev\n```\n\n### Build macOS App\n\n```bash\nnpm run tauri build\n```\n\nExpected output:\n\n- `src-tauri/target/release/bundle/macos/Android Toolkit.app`\n- `src-tauri/target/release/bundle/dmg/Android Toolkit_\u003cversion\u003e_\u003carch\u003e.dmg`\n\n### Build macOS App For Distribution\n\n```bash\nnpm run build:mac\n```\n\nThis ad-hoc build flow:\n\n- builds the macOS `.app` bundle with `Tauri`\n- signs the `.app` with `codesign --force --deep --options runtime -s -`\n- creates a DMG using `create-dmg`\n- signs the final `.dmg` with an ad-hoc identity\n\nInstall `create-dmg` first:\n\n```bash\nbrew install create-dmg\n```\n\n### Notes For macOS\n\n- The macOS bundle config uses `bundle.macOS.signingIdentity` set to `\"-\"` so ad-hoc signing is the default identity for local macOS bundles.\n- Ad-hoc signing should produce the standard \"Unidentified Developer\" warning on other Macs instead of a damaged-app error, but it does not notarize the app.\n- For fully trusted public distribution without the extra Gatekeeper confirmation flow, you still need a valid Apple `Developer ID Application` certificate and notarization.\n\n### If macOS Blocks The DMG Or App\n\nBecause the current macOS build is ad-hoc signed and not notarized, Gatekeeper may block it the first time.\n\nYou may need to do this twice:\n\n1. For the DMG installer\n2. Again for the app the first time you open `Android Toolkit.app`\n\nUse this flow each time macOS blocks it:\n\n1. Try to open the blocked `.dmg` or `.app`\n2. When macOS shows the warning, click `Done`\n3. Open `System Settings`\n4. Go to `Privacy \u0026 Security`\n5. Scroll down to the `Security` section\n6. Click `Open Anyway` for the blocked item\n7. Confirm the prompt and open it again\n\nIf you install from the DMG, expect to repeat the same `Open Anyway` process once for the installer and once again for the app itself on first launch.\n\n## Windows Setup\n\n### Requirements\n\n- `Node.js` + `npm`\n- `Rust`\n- `Visual Studio Build Tools` with C++ workload\n- `WebView2` runtime\n\nRecommended installs:\n\n- Node.js: [https://nodejs.org](https://nodejs.org)\n- Rust: [https://rustup.rs](https://rustup.rs)\n- Visual Studio Build Tools: [https://visualstudio.microsoft.com/visual-cpp-build-tools/](https://visualstudio.microsoft.com/visual-cpp-build-tools/)\n- WebView2: [https://developer.microsoft.com/en-us/microsoft-edge/webview2/](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)\n\n### Recommended Local Path\n\n```powershell\nmkdir C:\\Projects\ncd C:\\Projects\ngit clone https://github.com/TeamNocturnal/AndroidToolkit.git\ncd AndroidToolkit\nnpm install\n```\n\n### Run In Dev Mode\n\n```powershell\nnpm run tauri dev\n```\n\n### Build Windows App\n\n```powershell\nnpm run tauri build\n```\n\n### Notes For Windows\n\n- If you plan to build Android on Windows too, keep your Android SDK / NDK / Java paths configured in your environment first.\n- The older environment notes in [WINDOWS_ENV.md](/Users/xs/Library/CloudStorage/OneDrive-Personal/Team%20Nocturnal/Projects/Nocturnal%20Toolkit/WINDOWS_ENV.md) are still useful as a machine-specific reference.\n\n## Linux Setup\n\nLinux desktop builds are now supported for `x86_64` systems, including `Debian`, `Fedora`, `Arch Linux`, and `openSUSE`.\n\n### Requirements\n\n- `Node.js` + `npm`\n- `Rust`\n- Tauri Linux system dependencies\n- `xdg-open` support from your desktop environment for reveal-in-folder actions\n\nOfficial links:\n\n- Node.js: [https://nodejs.org](https://nodejs.org)\n- Rust / rustup: [https://rustup.rs](https://rustup.rs)\n- Tauri Linux prerequisites: [https://v2.tauri.app/start/prerequisites/](https://v2.tauri.app/start/prerequisites/)\n- Android SDK Platform-Tools: [https://developer.android.com/tools/releases/platform-tools](https://developer.android.com/tools/releases/platform-tools)\n\nInstall the common app dependencies first, then the distro-specific packages below.\n\n### Debian\n\nBased on the current Tauri v2 prerequisites:\n\n```bash\nsudo apt update\nsudo apt install \\\n  libwebkit2gtk-4.1-dev \\\n  build-essential \\\n  curl \\\n  wget \\\n  file \\\n  libxdo-dev \\\n  libssl-dev \\\n  libayatana-appindicator3-dev \\\n  librsvg2-dev \\\n  nodejs \\\n  npm\ncurl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh\nsource \"$HOME/.cargo/env\"\nnpm -v\nnode -v\n```\n\nIf you want a quick ADB check on Debian before opening the app:\n\n```bash\nadb version\nadb devices\n```\n\n### Arch Linux\n\nBased on the current Tauri v2 prerequisites:\n\n```bash\nsudo pacman -Syu\nsudo pacman -S npm\nnpm -v\nsudo pacman -S --needed \\\n  webkit2gtk-4.1 \\\n  base-devel \\\n  curl \\\n  wget \\\n  file \\\n  openssl \\\n  appmenu-gtk-module \\\n  libappindicator-gtk3 \\\n  librsvg \\\n  xdotool \\\n  nodejs \\\n  npm\ncurl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh\nsource \"$HOME/.cargo/env\"\nnode -v\nnpm -v\n```\n\nIf `npm` was not already present on your Arch system, the minimal install flow is:\n\n```bash\nsudo pacman -Syu\nsudo pacman -S npm\nnpm -v\n```\n\nIf you want a quick ADB check on Arch before opening the app:\n\n```bash\nadb version\nadb devices\n```\n\n### Fedora\n\nBased on the current Tauri v2 prerequisites:\n\n```bash\nsudo dnf check-update\nsudo dnf install \\\n  webkit2gtk4.1-devel \\\n  openssl-devel \\\n  curl \\\n  wget \\\n  file \\\n  libappindicator-gtk3-devel \\\n  librsvg2-devel \\\n  libxdo-devel \\\n  nodejs \\\n  npm\nsudo dnf group install \"c-development\"\ncurl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh\nsource \"$HOME/.cargo/env\"\nnode -v\nnpm -v\n```\n\nIf you want a quick ADB check on Fedora before opening the app:\n\n```bash\nadb version\nadb devices\n```\n\n### openSUSE\n\nBased on the current Tauri v2 prerequisites:\n\n```bash\nsudo zypper up\nsudo zypper in \\\n  webkit2gtk3-devel \\\n  libopenssl-devel \\\n  curl \\\n  wget \\\n  file \\\n  libappindicator3-1 \\\n  librsvg-devel \\\n  nodejs \\\n  npm\nsudo zypper in -t pattern devel_basis\ncurl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh\nsource \"$HOME/.cargo/env\"\nnode -v\nnpm -v\n```\n\nIf you want a quick ADB check on openSUSE before opening the app:\n\n```bash\nadb version\nadb devices\n```\n\n### Recommended Local Path\n\n```bash\nmkdir -p ~/Projects\ncd ~/Projects\ngit clone https://github.com/TeamNocturnal/AndroidToolkit.git\ncd AndroidToolkit\nnpm install\n```\n\n### Run In Dev Mode\n\n```bash\nnpm run tauri dev\n```\n\n### Quick ADB Sanity Check\n\nBefore debugging Android Toolkit itself, make sure the host can see your phone:\n\n```bash\nadb version\nadb start-server\nadb devices\n```\n\nIf you see an empty device list on Linux, finish the USB rules steps in [LINUX_USB.md](/Users/xs/Projects/AndroidToolkit/LINUX_USB.md), reconnect the phone, unlock it, and accept the USB debugging prompt on the device.\n\n### Compile Linux App\n\nUse the same desktop build command on `Debian`, `Fedora`, `Arch Linux`, and `openSUSE` after installing the distro-specific dependencies above:\n\n```bash\nnpm run tauri build\n```\n\nExpected output will usually include Linux bundle directories such as:\n\n- `src-tauri/target/release/bundle/appimage/`\n- `src-tauri/target/release/bundle/deb/`\n- `src-tauri/target/release/bundle/rpm/`\n\nDepending on the host distro and installed tooling, Tauri may emit one or more Linux package artifacts inside those folders.\n\n## Android Build Notes\n\nAndroid builds are optional and are separate from the desktop app.\n\nYou will need:\n\n- Android Studio or command line Android SDK tools\n- Android SDK\n- Android NDK\n- Java / JDK\n\nTypical Android environment variables:\n\n```bash\nANDROID_HOME=/path/to/android/sdk\nANDROID_SDK_ROOT=/path/to/android/sdk\nNDK_HOME=/path/to/android/sdk/ndk/\u003cversion\u003e\nJAVA_HOME=/path/to/jdk\n```\n\n### Build Android\n\n```bash\nnpm run tauri android build\n```\n\n## Common Commands\n\n### Frontend only\n\n```bash\nnpm run dev\n```\n\n### Desktop dev app\n\n```bash\nnpm run tauri dev\n```\n\n### Desktop production build\n\n```bash\nnpm run tauri build\n```\n\n### Android production build\n\n```bash\nnpm run tauri android build\n```\n\n## Cleaning Build Output\n\n### Safe cleanup before rebuilding\n\nIf you need a clean rebuild, these folders are safe to remove:\n\n```bash\nrm -rf dist\nrm -rf node_modules\nrm -rf src-tauri/target\nrm -rf src-tauri/gen/android/app/build\nrm -rf src-tauri/gen/android/build\n```\n\nOn Windows, remove the same folders manually or with PowerShell.\n\nDo not remove the repo itself, `.git`, or the committed Android project files under `src-tauri/gen/android`.\n\n## Backlog\n\nThis backlog is meant to track the next meaningful steps, not every idea that has ever come up.\n\n### Desktop\n\n- Add a proper custom macOS drag-to-Applications installer experience.\n- Set up macOS signing + notarization for trusted DMG distribution.\n- Upgrade the current device preview into a true low-latency live mirroring pipeline.\n\n### Android\n\n- Finish Android window inset handling so the status/nav bars never overlap content on every device.\n- Continue improving Android cleanup and maintenance workflows with more guided review and result summaries.\n- Keep refining Android tablet/landscape layouts where needed.\n\n### Quest Tools\n\n- Add Lightning Launcher support.\n\n### Media / TV\n\n- Add remaining media apps still on the backlog:\n  - `RealStream`\n  - `Stream Cinema`\n  - `iMPlayer`\n  - `TiviMate`\n  - `VidHub`\n  - `SportzX`\n  - `TIDAL`\n  - `Fandango at Home`\n  - `Apple TV`\n- Verify the remaining unidentified screenshot-based media tiles before adding them.\n- Continue polishing Media section grouping and device-specific setup flows.\n\n## Notes\n\n- Desktop and Android intentionally do not behave the same in every area.\n- Android-only changes should stay isolated from the desktop build.\n- Generated build output is intentionally not kept in Git history unless needed.\n\n## Team Nocturnal\n\nBuilt by `XsMagical` / Team Nocturnal.\n\n## Repo And Build From Source\n\n### Before You Start\n\n- Keep this repo in a normal local folder, not inside `OneDrive`, `iCloud Drive`, `Dropbox`, or other live-sync folders.\n- Cloud sync can corrupt Git metadata, duplicate build files, and cause huge storage churn with `target` and Android build output.\n- Use `GitHub` and regular `git pull` / `git push` for sync and history instead of a file-sync service.\n- Good local paths:\n  - macOS: `~/Projects/AndroidToolkit`\n  - Linux: `~/Projects/AndroidToolkit`\n  - Windows: `C:\\Projects\\AndroidToolkit`\n\n### 1. Clone The Repo\n\n```bash\ngit clone https://github.com/TeamNocturnal/AndroidToolkit.git\ncd AndroidToolkit\ngit config user.name \"XsMagical\"\ngit config user.email \"XsMagical@Team-Nocturnal.com\"\n```\n\n### 2. Install JavaScript Dependencies\n\n```bash\nnpm install\n```\n\n### Advanced\n\n#### GitHub Sync\n\nThis repo should stay in sync through `GitHub`, not through `OneDrive` or another live-sync folder.\n\n#### Clone the repo\n\n```bash\ngit clone https://github.com/TeamNocturnal/AndroidToolkit.git\ncd AndroidToolkit\n```\n\n#### Check your remote\n\n```bash\ngit remote -v\n```\n\nThe main remote should point to:\n\n```bash\nhttps://github.com/TeamNocturnal/AndroidToolkit.git\n```\n\n#### Optional Git identity setup\n\nIf you have not set your Git name and email on this machine yet, configure them with your own details:\n\n```bash\ngit config user.name \"Your Name\"\ngit config user.email \"you@example.com\"\n```\n\n#### Pull the latest changes\n\n```bash\ngit checkout main\ngit pull --ff-only origin main\nnpm install\n```\n\n#### Linux Notes\n\n- This branch currently bundles Linux `adb` and `fastboot` sidecars for `x86_64-unknown-linux-gnu`.\n- Bundled `adb` and `fastboot` do not remove the need for Linux USB permissions. If a phone does not appear in `adb devices` or `fastboot devices`, follow the Linux USB setup guide in [LINUX_USB.md](/Users/xs/Projects/AndroidToolkit/LINUX_USB.md).\n- `AppRun` inside `*.AppDir` is a staging helper created during AppImage packaging. It is not the supported launch target. Launch the finished `.AppImage`, a native package, or the release binary instead.\n- If AppImage bundling fails while `linuxdeploy` runs on Arch or another rolling distro, retry with `APPIMAGE_EXTRACT_AND_RUN=1 npm run tauri build`. That environment variable avoids a common AppImage runtime issue during the packaging step.\n- Android builds on Linux still require your `ANDROID_HOME`, `ANDROID_SDK_ROOT`, `NDK_HOME`, and `JAVA_HOME` environment variables to be configured first.\n\nRun `npm install` after pulling any time `package.json` or `package-lock.json` changed.\n\n#### Check your local changes\n\n```bash\ngit status\ngit diff --stat\n```\n\n#### Push your updates back to GitHub\n\n```bash\ngit checkout main\ngit pull --ff-only origin main\ngit status\ngit add -A\ngit commit -m \"Short clear summary of changes\"\ngit push origin main\n```\n\n#### Use a branch when the change is bigger\n\nIf the update is larger or you want a cleaner review path, use a branch:\n\n```bash\ngit checkout main\ngit pull --ff-only origin main\ngit checkout -b codex/short-change-name\ngit add -A\ngit commit -m \"Short clear summary of changes\"\ngit push -u origin codex/short-change-name\n```\n\n#### If Git says your branch is behind\n\n```bash\ngit checkout main\ngit pull --ff-only origin main\n```\n\nThen run your commit or branch steps again.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamnocturnal%2Fandroidtoolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteamnocturnal%2Fandroidtoolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamnocturnal%2Fandroidtoolkit/lists"}