DeviceSpoofLabs

https://github.com/yubunus/devicespooflab-magisk
Admin
DeviceSpoofLabs is a Magisk module that spoofs device identity properties to present an Android...
Tokens:4,207
Snippets:44
Trust Score:7.7
License:MIT
Update:6 months ago
Show doc for...
Tokens:
Raw
### Configuration File Format Example

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Configuration files use a CSV format with ENABLED/DISABLED status and dynamic value generators. Use this format to define which properties to spoof and their values.

```bash
# Config file format: STATUS,PROPERTY_NAME,VALUE
# STATUS: ENABLED or DISABLED
# File-level control: FILE_ENABLED or FILE_DISABLED at top

# Example: config/device_identity.conf
FILE_ENABLED
ENABLED,ro.product.brand,google
ENABLED,ro.product.manufacturer,Google
ENABLED,ro.product.model,Pixel 7 Pro
ENABLED,ro.product.name,cheetah
ENABLED,ro.product.device,cheetah
DISABLED,ro.product.board,cheetah  # This prop is skipped

# Example: config/identifiers.conf with generators
ENABLED,ro.serialno,${RANDOM_SERIAL}           # 12-char alphanumeric
ENABLED,ro.bootloader,cheetah-1.2-${RANDOM_HEX:8}  # 8-char hex suffix
ENABLED,ANDROID_ID,${RANDOM_HEX:16}            # 16-char hex

# Available generators:
#   ${RANDOM_SERIAL}  - 12-character uppercase alphanumeric
#   ${RANDOM_HEX:N}   - N-character lowercase hex string
#   ${RANDOM_UUID}    - UUID format (8-4-4-4-12)
#   ${RANDOM_IMEI}    - Valid 15-digit IMEI with checksum
#   ${RANDOM_MAC}     - MAC address format (xx:xx:xx:xx:xx:xx)
#   ${FROM_BACKUP:prop.name} - Value from backup.conf
```

--------------------------------

### Install DeviceSpoofLab via Magisk

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Follow these steps to install the DeviceSpoofLab module using Magisk Manager. This process requires a rooted device with Magisk v24.0 or higher.

```bash
# Prerequisites:
# - Rooted Android device
# - Magisk v24.0 or higher
# - Magisk Manager app

# Step 1: Push module to device
adb push devicespooflab-v2.2.zip /sdcard/Download/

# Step 2: Install via Magisk Manager
# - Open Magisk Manager
# - Tap Modules (bottom navigation)
# - Tap Install from storage
# - Select devicespooflab-v2.2.zip
# - Reboot when prompted

# Step 3: First boot behavior
# - Original device identity automatically backed up
# - No spoofing applied yet (persona inactive)

# Step 4: Set up first persona
adb shell
su
devicespooflabs
# Select [1] Persona Management
# Select [2] Generate NEW persona
# Select [1] Generate IDs and spoof only
# Device reboots automatically

# Step 5: Verify after reboot
adb shell su -c 'getprop ro.product.model'
# Output: Pixel 7 Pro
```

--------------------------------

### Set Up Persona via CLI

Source: https://github.com/yubunus/devicespooflab-magisk/blob/main/README.md

Use the interactive CLI to generate and apply a new device persona.

```bash
adb shell
su
devicespooflabs
# Select [1] Persona Management
# Select [2] Generate NEW persona
# Select [1] or [2] to generate
# Reboot when prompted
```

--------------------------------

### Verify Device Properties

Source: https://github.com/yubunus/devicespooflab-magisk/blob/main/README.md

Use these commands to check various device properties after applying spoofing. Ensure the module is enabled and reboot if necessary.

```bash
# Check model
getprop ro.product.model
```

```bash
# Check fingerprint
getprop ro.build.fingerprint
```

```bash
# Check security patch
getprop ro.build.version.security_patch
```

```bash
# Check Android version
getprop ro.build.version.release
```

```bash
# Check ANDROID_ID
settings get secure android_id
```

```bash
# Check serial
getprop ro.serialno
```

```bash
# View module logs
cat /data/local/tmp/devicespooflab.log
```

--------------------------------

### Verify Spoofed Properties with ADB

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Use these ADB commands to verify that spoofed properties have been correctly applied after configuration. Ensure you have root access on the device.

```bash
# Check device model
adb shell su -c 'getprop ro.product.model'
# Expected: Pixel 7 Pro

# Check build fingerprint
adb shell su -c 'getprop ro.build.fingerprint'
# Expected: google/cheetah/cheetah:15/AP4A.241205.013/12621605:user/release-keys

# Check security patch level
adb shell su -c 'getprop ro.build.version.security_patch'
# Expected: 2024-12-05

# Check Android version
adb shell su -c 'getprop ro.build.version.release'
# Expected: 15

# Check serial number
adb shell su -c 'getprop ro.serialno'
# Expected: [randomized 12-char string]

# Check ANDROID_ID
adb shell su -c 'settings get secure android_id'
# Expected: [randomized 16-char hex string]

# View module logs
adb shell su -c 'cat /data/local/tmp/devicespooflab.log'
```

--------------------------------

### DeviceSpoofLab Module File Locations

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

This lists the important file paths for the module's configuration, data, and logs. These paths are crucial for managing the module's state and troubleshooting.

```bash
# Module installation directory
/data/adb/modules/devicespooflab/

# Configuration files
/data/adb/modules/devicespooflab/config/device_identity.conf
/data/adb/modules/devicespooflab/config/build_info.conf
/data/adb/modules/devicespooflab/config/security.conf
/data/adb/modules/devicespooflab/config/hardware.conf
/data/adb/modules/devicespooflab/config/identifiers.conf
/data/adb/modules/devicespooflab/config/carrier.conf
/data/adb/modules/devicespooflab/config/custom.conf
/data/adb/modules/devicespooflab/config/early_boot.conf

# Persona state and backup
/data/adb/modules/devicespooflab/config/persona_active  # Flag file
/data/adb/modules/devicespooflab/config/backup.conf     # Original device values

# Log file
/data/local/tmp/devicespooflab.log
```

--------------------------------

### Verify Spoofed Properties

Source: https://github.com/yubunus/devicespooflab-magisk/blob/main/README.md

Check the device model and build fingerprint to confirm the spoofing is active.

```bash
adb shell su -c 'getprop ro.product.model'
# Should output: Pixel 7 Pro

adb shell su -c 'getprop ro.build.fingerprint'
# Should output: google/cheetah/cheetah:15/AP4A.241205.013/12621605:user/release-keys
```

--------------------------------

### Access the CLI

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Launch the interactive CLI tool within an ADB shell session with root privileges.

```bash
# Access the CLI (requires root)
adb shell
su
devicespooflabs

# Main menu options:
#   [1] Persona Management
#   [2] App Data / Cache Tools
#   [0] Exit
```

--------------------------------

### Execute DeviceSpoofLabs Script Directly

Source: https://github.com/yubunus/devicespooflab-magisk/blob/main/README.md

If the `devicespooflabs` command is not found, you can execute the script directly using its path. A symlink is typically created on reboot.

```bash
# Direct path
/data/adb/modules/devicespooflab/common/devicespooflabs.sh
```

```bash
# Or wait for next reboot (symlink created by service.sh)
```

--------------------------------

### Edit Configuration Files

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Access the configuration menu to manually edit spoofed properties.

```bash
# From devicespooflabs CLI:
# Select [1] Persona Management
# Select [6] Edit Config Files

# Available configs:
#   [1] device_identity.conf  - Brand, model, manufacturer
#   [2] build_info.conf       - Build fingerprint, security patch
#   [3] security.conf         - SafetyNet/Play Integrity props
#   [4] hardware.conf         - CPU, screen size, density
#   [5] identifiers.conf      - Serial, ANDROID_ID
#   [6] carrier.conf          - GSM/SIM operator info
#   [7] custom.conf           - User-defined props
#   [8] Toggle Dimension Spoof (currently: ON/OFF)
```

--------------------------------

### Restore Original Device

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Revert the device to its original identity using the automatic backup.

```bash
# From devicespooflabs CLI:
# Select [1] Persona Management
# Select [3] Restore Default Persona

# Confirmation prompt:
# [*] This will restore original device values
# Continue? (yes/no): yes
# [+] Backup restored
# [*] Reboot to apply
```

--------------------------------

### Spoofed Properties Reference

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

A reference list of device properties that can be modified by the DeviceSpoofLab module. This helps in understanding which aspects of the device identity can be spoofed.

```bash
# Device Identity
ro.product.brand          # google
ro.product.manufacturer   # Google
ro.product.model          # Pixel 7 Pro
ro.product.name           # cheetah
ro.product.device         # cheetah
ro.product.board          # cheetah
ro.hardware               # cheetah
ro.board.platform         # gs201
```

--------------------------------

### Restore Original Device Persona

Source: https://github.com/yubunus/devicespooflab-magisk/blob/main/README.md

To revert to your original device identity, use the `devicespooflabs` command and select the restore option, followed by a reboot. Alternatively, uninstall the module via Magisk Manager.

```bash
su
devicespooflabs
# Select [1] Persona Management
# Select [3] Restore default persona
# Reboot
```

--------------------------------

### Generate New Persona

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Create a new device identity with randomized identifiers, offering options to preserve or clear application data.

```bash
# From devicespooflabs CLI:
# Select [1] Persona Management
# Select [2] Generate New Persona

# Option 1: Generate IDs and spoof only (keeps app data)
#   - Creates new serial, ANDROID_ID, bootloader
#   - Activates persona and reboots

# Option 2: Nuclear Option (full reset)
#   - Clears ALL 3rd party app data
#   - Clears Chrome, GMS, GSF, WebView
#   - Generates new identifiers
#   - Activates persona and reboots

# Generated identifiers example:
# [+] Serial: XY7K9M2P4Q8R
# [+] ANDROID_ID: 8f3a2b1c9d4e5f06
# [+] Bootloader: cheetah-1.2-a3f8b2c1
```

--------------------------------

### Uninstall DeviceSpoofLab Module

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Instructions for uninstalling the DeviceSpoofLab module and restoring the original device identity. You can choose between a CLI-based restore followed by Magisk uninstallation or direct removal via Magisk Manager.

```bash
# Option 1: Restore via CLI then uninstall
adb shell
su
devicespooflabs
# Select [1] Persona Management
# Select [3] Restore default persona
# Reboot

# Then remove module via Magisk Manager:
# - Open Magisk Manager
# - Go to Modules
# - Uninstall "DeviceSpoofLabs"
# - Reboot

# Option 2: Direct removal via Magisk Manager
# (Original values will be restored after module removal and reboot)
```

--------------------------------

### View Current Persona Status

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Display the currently active spoofed device properties and identifiers.

```bash
# From devicespooflabs CLI:
# Select [1] Persona Management
# Select [1] View Current Persona Status

# Output example:
# Current Spoofed Values (Live):
# ─────────────────────────────────
#   Model:       Pixel 7 Pro
#   Brand:       google
#   Device:      cheetah
#   Fingerprint: google/cheetah/cheetah:15/AP4A.241205.013/12621605:user/release-keys
#   Build ID:    AP4A.241205.013
#   Android:     15 (SDK 35)
#   Security:    2024-12-05
#   Serial:      ABC123DEF456
#   ANDROID_ID:  a1b2c3d4e5f67890
# ─────────────────────────────────
```

--------------------------------

### Clear All App Data

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Wipe data from third-party and critical system apps to reset device fingerprinting.

```bash
# From devicespooflabs CLI:
# Select [2] App Data / Cache Tools
# Select [1] Clear ALL app data

# WARNING: This will clear ALL app data and cache!
# This includes:
#   - All 3rd party apps (game progress, logins, etc)
#   - Chrome browser (history, passwords, cookies)
#   - Google Play Services & GSF
#   - WebView
#
# Protected (will NOT be cleared):
#   - Magisk & LSPosed (root management apps)
#   - System UI & Shell

# Continue? (y/n): y
# [i] Clearing critical system apps...
# [+] Cleared com.android.chrome
# [+] Cleared com.google.android.gms
# [i] Found 45 3rd party apps
# [i] Progress: 10/45 apps processed...
# [+] Cleared 42 3rd party apps
```

--------------------------------

### Activate or Deactivate Persona

Source: https://context7.com/yubunus/devicespooflab-magisk/llms.txt

Toggle the current persona spoofing state without modifying existing identifiers.

```bash
# Activate persona (from CLI menu):
# Select [1] Persona Management
# Select [4] Activate Persona
# [+] Persona activated!
# [*] Rebooting in 3 seconds...

# Deactivate persona (from CLI menu):
# Select [1] Persona Management
# Select [5] Deactivate Persona
# [+] Persona deactivated!
# [*] Rebooting in 3 seconds...
```
Tokens:
Raw