Skip to main content
Capgo logo
Back to plugins
@capgo/capacitor-intent-launcher
Tutorial
by github.com/Cap-go

Intent Launcher

Launch Android intents, open system settings, and interact with other apps using the Intent system

Downloads/week

3.9k

GitHub Stars

6

Guide

Tutorial on Intent Launcher

Using @capgo/capacitor-intent-launcher

Capacitor Intent Launcher Plugin for launching Android intents and opening system settings on both Android and iOS.

Install

bun add @capgo/capacitor-intent-launcher
bunx cap sync

What This Plugin Exposes

  • startActivityAsync - Starts an Android activity for the given action.
  • openIOSSettings - Opens iOS settings screen.
  • openApplication - Opens an application by its package name.
  • getApplicationIconAsync - Gets the application icon as a base64-encoded PNG string.

Example Usage

startActivityAsync

Starts an Android activity for the given action.

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

// Open location settings
const result = await IntentLauncher.startActivityAsync({
  action: ActivityAction.LOCATION_SOURCE_SETTINGS
});

// Open a specific app settings
const result = await IntentLauncher.startActivityAsync({
  action: ActivityAction.APPLICATION_DETAILS_SETTINGS,
  data: 'package:com.example.app'
});

openIOSSettings

Opens iOS settings screen.

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

// Open app settings (recommended - officially supported by Apple)
await IntentLauncher.openIOSSettings({ option: IOSSettings.App });

// Open WiFi settings (may not work in all iOS versions)
await IntentLauncher.openIOSSettings({ option: IOSSettings.WiFi });

openApplication

Opens an application by its package name.

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

// Open Gmail app
await IntentLauncher.openApplication({ packageName: 'com.google.android.gm' });

getApplicationIconAsync

Gets the application icon as a base64-encoded PNG string.

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

const { icon } = await IntentLauncher.getApplicationIconAsync({
  packageName: 'com.google.android.gm'
});
if (icon) {
  const img = document.createElement('img');
  img.src = icon;
}

Full Reference

Keep going from Using @capgo/capacitor-intent-launcher

If you are using Using @capgo/capacitor-intent-launcher to plan dashboard and API operations, connect it with @capgo/capacitor-intent-launcher for the implementation detail in @capgo/capacitor-intent-launcher, Getting Started for the implementation detail in Getting Started, API Overview for the implementation detail in API Overview, Introduction for the implementation detail in Introduction, and API Keys for the implementation detail in API Keys.