> ## Documentation Index
> Fetch the complete documentation index at: https://filekit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Open file dialog

> Open a file with the default application in a Kotlin Multiplatform project

<Check>Supported on Android, iOS, macOS and JVM targets</Check>

## Quick start

The open file function allows you to open any file with the default application associated with that file type on the user's device. This is useful for viewing documents, images, or any other file type without handling the content within your app.

```kotlin filekit-dialogs theme={null}
val file = PlatformFile("/path/to/document.pdf")
FileKit.openFileWithDefaultApplication(file)
```

This will open the file using the system's default application for that file type - for example, a PDF viewer for `.pdf` files, an image viewer for `.jpg` files, or a text editor for `.txt` files.

<Info>
  Ensure the file you are trying to open exists and is accessible. Attempting to open a non-existent file will result in an error.
</Info>

## Android setup

Opening files on Android requires additional FileProvider configuration to securely share files with other applications. Starting from Android 7.0 (API level 24), Android restricts the sharing of file URIs between apps for security reasons. FileProvider generates secure content URIs that allow temporary access to specific files.

**Why FileProvider is required?**

Android uses FileProvider to:

* **Enhance security**: Prevents exposing your app's internal file structure to other apps
* **Control access**: Grants temporary, limited access to specific files only
* **Maintain compatibility**: Required for opening files on Android 7.0+ due to `FileUriExposedException`

When using custom file locations on Android, you need to configure a FileProvider in your app:

<Info>
  For detailed information about FileProvider, see the [official Android documentation](https://developer.android.com/reference/androidx/core/content/FileProvider).
</Info>

1. Add the FileProvider to your `AndroidManifest.xml`:

```xml theme={null}
<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>
```

2. Create `androidMain/res/xml/file_paths.xml`:

```xml theme={null}
<paths>
    <cache-path name="filekit_cache" path="." />
    <files-path name="filekit_files" path="." />
</paths>
```

<Info>
  **Important**: Include only the path type that matches your FileKit usage:

  * Use `<files-path>` if you use `FileKit.filesDir`
  * Use `<cache-path>` if you use `FileKit.cacheDir`
  * Include both if you use both directories
</Info>

3. When opening files from custom locations, provide the `openFileSettings` parameter with your app's FileProvider authority:

```kotlin filekit-dialogs theme={null}
val file = FileKit.filesDir / "document.pdf"
FileKit.openFileWithDefaultApplication(
    file = file,
    openFileSettings = FileKitOpenFileSettings(
        authority = "${context.packageName}.fileprovider"
    )
)
```

<Warning>
  If you don't provide the correct FileProvider authority when opening files from custom locations on Android, the operation will fail with a `FileUriExposedException` on Android 7.0 and above.
</Warning>