English · 简体中文
Fresh wallpapers. A little feline charm.
An on-device Collections wallpaper installer for iOS, built with SwiftUI and Rust.
Pawster helps you import Collections .tendies packs, check where they will go, and add them to the system wallpaper collection. Installation history keeps verification results and rollback actions close at hand—a little care with every pawprint.
Network-based paths use a local VPN to find the PosterBoard container through system services. File access uses bad_query or worse_query; AirTraffic and the older-system Pocket / Trash route are separate experimental transfers. Pocket manual UUID mode can work without pairing or a VPN.
Experimental software: automated checks cover app logic and resources, but pairing, wallpaper visibility, and system UI refresh still need confirmation on real devices. Check the compatibility table before installing.
Wallpaper library · Getting Started · Welcome and privacy choices. Captured in a clean iOS simulator; device connection and wallpaper results depend on the compatibility below.
Pawster currently enables the following wallpaper installation paths:
| iOS version | Access engine | Pairing |
|---|---|---|
| 17.0–18.7.2 | Experimental Trash | Manual UUID; pairing/VPN optional for discovery |
| 26.0–26.1 | worse_query default; bad_query or experimental Trash |
Imported file for discovery; manual UUID for Trash |
| 26.1.1–26.6.1 | worse_query default; bad_query selectable |
Imported file |
| 26.6.2–26.7.2 | worse_query |
Imported file |
27.0 beta 4 (24A5390f) |
worse_query default; bad_query or experimental AirTraffic |
Native or imported |
| 27.0–27.0.1 | worse_query default; experimental AirTraffic selectable |
Native or imported |
27.2 beta 1–2 (24B5084k, 24B5089g) |
worse_query default; experimental AirTraffic selectable |
Native or imported |
| Other 27.0–27.2.1 builds | worse_query |
Native or imported |
27.3 beta 1 (24C5037i) |
worse_query; exact build required |
Native or imported |
| Other versions | Installation unavailable | Pairing does not imply wallpaper support |
On iOS 17.0–18.7.2, Pawster offers experimental installation through Trash. This path is also selectable on 26.0–26.1, where worse_query remains the default. Entering the PosterBoard UUID manually needs no pairing file or VPN; these are optional for path discovery. See older-system setup.
Choose an available engine in Connection → Paths & Compatibility. Switching engines requires a new path check and plan. The choice is remembered for the current system build. See compatibility and device reports for detailed limits.
Pawster also offers experimental AirTraffic/Airlift on the versions listed above. It requires Apple Books, a pairing file and a local VPN, but no App Group. Both Trash and AirTraffic leave the target unverified: completing a transfer does not confirm that the wallpaper is installed or visible. These paths do not offer wallpaper rollback or registration refresh; system UI refresh is manual. See AirTraffic setup and recovery.
Native compilation and automated tests have passed; real-device validation remains pending. The table describes installation paths enabled in Pawster, without guaranteeing compatibility on every device. Support for one beta build does not extend to other builds with a similar version number.
Pawster currently handles Collections wallpaper packs. Other .tendies providers are not supported.
- Import and preview Collections
.tendiespacks from Files. - Review the destination and access engine before confirming an installation.
- Add new wallpaper descriptors while preserving existing descriptor directories.
- Verify written content and keep a record of each installation.
- Roll back an installation from its history entry. If its files have changed, Pawster stops the rollback for review.
- Swipe left to delete an imported pack from the local library.
- A first-use guide walks through LocalDevVPN, Developer Mode, and pairing, with progress saved across app launches.
- Import an existing pairing file or pair on the device on iOS 27.
- Follow a Picture in Picture guide with the live six-digit code while using Settings.
- View the local VPN route status, Iface IP, and Peer IP; set a peer override when needed.
- Replace or remove saved pairing credentials from the app.
- Refresh the system interface manually with NeoSpring, or opt into automatic refresh after a verified installation.
- Switch between light, dark, and system appearance.
- Enjoy a subtle animated background, with an option to pause it.
- Use US English or Simplified Chinese. Available regional Chinese translations take precedence; otherwise Chinese falls back to Simplified Chinese. Other unavailable languages fall back to US English.
- An iPhone or iPad running a version listed in the compatibility table.
- A sideloading setup that preserves the app's required entitlements; the installation steps below use SideStore.
- LocalDevVPN, or an equivalent route, for service-based discovery and injection. Pocket manual UUID mode does not require it.
- Developer Mode as required by your installation method. Pairing is required for service-based operations; Pocket manual UUID mode skips it.
Keep the device unlocked and the local VPN connected when pairing or accessing system wallpaper files.
GotTal provides official Pawster builds free of charge, with no paid activation code, membership or feature unlock. If you paid another channel, ask the seller what the fee covers; official downloads remain free. Third-party services and redistribution retain their own applicable terms.
- Download the IPA from the latest Release. Public Release assets do not require GitHub sign-in.
- Verify the original download with the detached signature, public certificate, and SHA-256 manifest attached to the Release. See file verification for commands and the pinned certificate fingerprint.
- Add the IPA in SideStore and re-sign it with your own Apple ID.
- Open Pawster and follow Getting Started. You can resume the guide from Connection or Settings at any time.
The release signature checks the downloaded file; it does not replace SideStore re-signing. Test and release builds share an app identifier, so installing one replaces the other. For future versions, check the latest release.
On a supported older system, Getting Started asks for this device’s PosterBoard UUID or container root. Paste it or import a small NuggetPosterBoardHash text file in Connection, then review the plan. Optional pairing-based discovery is available if you already have credentials and a local VPN. The existing Nugget Helper does not deliver files automatically to Pawster.
The built-in guide is the easiest place to start. These steps are also here when you need a quick reference.
Connect to a Wi-Fi network first, and keep it connected while using LocalDevVPN. Cellular data alone is not enough. Open LocalDevVPN, keep its default settings for a first setup, and tap Connect. Approve the VPN configuration when iOS asks, then return to Pawster. If you already have a working configuration, you can keep it.
In Connection → Network Status, check Wi-Fi and the VPN separately, along with the VPN addresses. With a custom configuration, Pawster's Peer IP should match LocalDevVPN's Device IP. A connected badge indicates a detected tunnel route; the subsequent path query checks the actual system connection.
Open Settings → Privacy & Security → Developer Mode, turn it on, and follow the restart prompt. After restarting, unlock the device and confirm Enable when asked. Reconnect LocalDevVPN before returning to Pawster. If Developer Mode is already enabled, continue to pairing.
If the option is missing, follow Apple's Developer Mode guide. Pawster's Open This App’s System Settings button opens its own settings page; go back to the main Settings page to follow the path above.
On-device pairing — iOS 27
- In Connection, tap Start On-device Pairing, or Pair Again if a file is already saved.
- Once the session starts, open Settings → Privacy & Security → Developer Mode → Pair with Pawster.
- Enter the live six-digit code when it appears in the guide window or Pawster. Return to the app after pairing succeeds.
Allow local network access if prompted. If the guide window is unavailable, return to Pawster to view or copy the current code.
Import an existing pairing file
Tap Import Pairing File, or Replace Pairing File, and select your exported .mobiledevicepairing or .plist file. If you use SideStore, the file may be available at:
Files → On My iPhone → SideStore → ALTPairingFile.mobiledevicepairing
Files exported from another pairing tool or computer can also be selected in Files. A ready file has passed local format checks; use the path query below to confirm that the device still accepts it.
For Pocket Poster manual UUID mode, follow the setup above; the network steps below apply to the other engines.
- Keep the local VPN connected and the device unlocked.
- In Connection, tap Find Path.
- In Wallpapers, choose Import .tendies, then select a pack.
- Tap Review & Install Wallpapers, check the plan, and choose Confirm Injection.
- Open the system wallpaper picker to check the result and choose your wallpaper.
If the new wallpaper is not listed, open Settings → Operation History and use Back Up and Refresh Registration for the completed installation. Refresh System UI (NeoSpring) is a separate, optional action. It may briefly turn the screen black, return to the Lock Screen, or close the app; automatic refresh is off by default.
To undo an installation, use Roll Back This Injection in its history entry. Deleting an imported pack only removes Pawster's local copy; it does not remove the installed wallpaper or its history.
- macOS and Xcode with the iOS 26 SDK or later. Apple silicon is recommended; the provided simulator build targets arm64.
- Rust stable and XcodeGen.
git clone https://github.com/GotTal/Pawster.git
cd Pawster
brew install xcodegen
bash Scripts/build-core.sh
PAWSTER_BUILD_CHANNEL=release bash Scripts/build-ipa.shThe IPA is written to build/Packages/. The script applies an ad-hoc signature; re-sign the package with your sideloading setup before installing it.
python3 Scripts/check-localizations.py
cargo test --locked --manifest-path Core/Cargo.toml --features device
xcrun simctl list devices available
TEST_DESTINATION='platform=iOS Simulator,id=SIMULATOR_UDID' bash Scripts/test-macos.shReplace SIMULATOR_UDID with an available iOS 26-or-later simulator's identifier. Simulator tests cover app logic and resources; they do not establish real-device wallpaper compatibility.
Without a Mac, use the Build and test Pawster GitHub Actions workflow in your fork, selecting a branch containing the version you want to build. Successful runs attach an IPA artifact.
Pawster/
├── App/ SwiftUI app, setup guide, pairing, wallpapers, and settings
│ └── Resources/ App icon, language packs, and offline legal documents
├── Core/ Rust core, protocol bridges, and vendored dependencies
├── Tests/ Swift tests
├── Scripts/ Build, test, and resource-validation scripts
├── Docs/ Validation records and device checks
├── ThirdParty/ Source attributions and license notices
├── project.yml XcodeGen project definition
├── LICENSE
├── README.md English
└── README_CN.md Simplified Chinese
- New to Pawster? See the setup FAQ and device compatibility reports.
- Ready to lend a paw? Start with Contributing, the architecture and project priorities.
- Report a bug, suggest a feature, or help with localization.
- Please follow the community code of conduct. Report vulnerabilities privately using the security policy.
Pawster is developed by GotTal, with thanks to the projects and people whose work made these little paws possible:
| Project | Contribution |
|---|---|
| AirCard-iOS | Pairing, local connection and container-query foundations, plus NeoSpring references |
| Pocket Poster | Older-system wallpaper installation through the Trash service |
| worse_query and bad_query | File-access engines |
| idevice | Device protocols and connection support; vendored through the AirCard snapshot |
| LocalDevVPN | Local VPN tooling used during setup |
| NeoSpring | System UI refresh research; attribution includes @neonmodder123 and @skadz108 |
| Erosion | PosterBoard investigation and design reference |
Pinned sources, modifications, and notices are listed in the third-party source notes.
- Report bugs or suggest improvements in Issues.
- Contact GotTal for private feedback or privacy-related questions.
- Help translate the app using the localization guide.
For bug reports, include your iOS version, Pawster build, and the error shown. Keep pairing files, live codes, and private wallpaper content out of public reports.
If Pawster earns a place on your phone, a Star is a lovely little treat. 🐟
Pawster's own code is licensed under GPL-3.0-or-later; see LICENSE. Third-party components retain their original terms and notices. Some upstream licensing details remain unresolved; review the source notes before redistributing a build. Wallpaper content retains its creators' rights and licenses.
The Terms of Use and Privacy Policy are also available offline in Settings. The app has no developer-operated account service or analytics SDK; pairing credentials stay in its private storage, and in-app diagnostic logging is off by default. Connections go to the peer address you configure.
Pocket Poster-derived adapter files retain GPL v3 terms; see the retained upstream license and source notices.


