# Magic Picker documentation

> Magic Picker lets a Magic app pick a file, an image or a video and get a MagicFile back through the Pick facade.

## Getting Started

- [Installation](https://anilcancakir.com/magic/docs/picker/getting-started/installation.md): Add magic_picker to a Magic app, register its provider and check that Pick opens a picker.

## The Basics

- [Pick](https://anilcancakir.com/magic/docs/picker/basics/pick.md): Open the system gallery, camera, file dialog and save dialog through the Pick facade and get a MagicFile back on every platform.
- [Download](https://anilcancakir.com/magic/docs/picker/basics/download.md): Offer a stored file to the user with Storage.download: the share sheet on mobile, macOS and Windows, the save dialog on Linux, a browser download on the web.
- [XFile Conversion](https://anilcancakir.com/magic/docs/picker/basics/xfile.md): Move between MagicFile and XFile with the toMagicFile and toXFile extensions.

## Guides

- [Testing](https://anilcancakir.com/magic/docs/picker/guides/testing.md): Test code that calls Pick, Storage.download and the XFile conversions without a device, a share sheet or a mocking library.

## Optional

- [Magic Picker](https://anilcancakir.com/magic/picker): the package landing page
- [Full documentation](https://anilcancakir.com/magic/docs/picker/llms-full.txt): every page in one file