Mod Store

Mod Store

The Mod Store installs and manages extension modules for Ava, supporting both special hardware and general Android device enhancements.

---

Overview

The Mod Store allows you to install extension modules that add new features, device support, and custom integrations to Ava. Mods can continuously expand what Ava can do.

What Mods Can Do:

• Add support for special hardware devices
• Add GPIO, system interface, and service call capabilities
• Extend device attributes and automation flows
• Add custom Ava interaction logic
• Integrate open-source components

---

Access the Mod Store

1. Go to Settings -> Advanced -> Mod Store
2. Browse available mods
3. Install, enable, disable, or manage mods

---

Mod Store Interface

Section	Description
Installed	Mods currently installed
Available	Mods available for installation
Refresh	Check for new mods
Manage	Configure installed mods

---

Managing Mods

Install a Mod

1. Go to Settings -> Advanced -> Mod Store
2. Find the mod in the Available list
3. Tap to download
4. The voice service will restart to apply changes

Enable / Disable

1. Find the mod in the Installed list
2. Tap Enable or Disable
3. The voice service restarts to apply changes

Update

1. Tap Update on an installed mod
2. The voice service restarts to apply changes

Uninstall

1. Find the mod in the Installed list
2. Tap Manage -> Uninstall
3. Confirm deletion

---

Mod Configuration

Some mods have configurable options:

1. Find the mod in the Installed list
2. Tap Manage
3. Configure available options
4. If no options are available, "This module has no configurable options" is shown

---

Permissions

Some mods require additional permissions:

• If a mod requires a permission that hasn't been granted, it cannot be enabled
• If permission is denied permanently, open app settings and allow the required permission for that module

---

Docs and Examples

Mod documentation and examples are available at:

• https://github.com/knoop7/ava-mods

---

Available Mods

Meta Portal Support

Brings Meta Portal ambient sensors, presence detection, sound level, screen timeout, and alert tone controls into Home Assistant through Ava, without requiring MQTT.

Based on the portal-ha-bridge project by RoadRunner-1024.

Features unlocked:

• Ambient light sensor
• Human presence detection
• Sound level sensor
• Screen timeout control
• Notification tone control

Setup:

1. Install the Meta Portal Support mod from Settings → Advanced → Mod Store
2. Download provision.sh from the mod source
3. Save provision.sh to your computer (e.g., Downloads folder)
4. Open Terminal and navigate to the folder:

   cd ~/Downloads

5. Make the script executable:

   chmod +x provision.sh

6. Connect your Meta Portal to the computer with USB and verify ADB can see it:

   adb devices

7. Run the provisioning command for Ava:

   ./provision.sh com.example.ava

Authorization options:

• Manual ADB authorization (always supported)
• Shizuku authorization (now supported)
• Automatic permission handling on rooted devices

Entry points:

• Settings → Advanced → Mod Store → Meta Portal Support
• Settings → Permissions → Shizuku Authorization

---

FAQ

Mod Store shows no mods?

1. Tap Refresh to check for available mods
2. Check network connection
3. Mods may not be available for your device

Mod installation failed?

1. Check network access
2. Check repository URL
3. Check module configuration
4. Try again later

Mod won't enable?

1. Check if the mod requires additional permissions
2. Grant the required permission
3. If permission was denied permanently, open app settings and allow it

Voice service restarts after mod changes?

This is expected. After enable, disable, or update, the voice service restarts automatically to apply changes.

---

Back to Home