<img height="100px" width="100px" alt="logo" src="./assets/images/logo.png"/>

# IRIS - A lightweight video player

[![Build Status](https://github.com/nini22P/iris/actions/workflows/ci.yml/badge.svg)](https://github.com/nini22P/iris/actions/workflows/ci.yml)
<a href="https://apps.microsoft.com/detail/9NML7WNHNRTJ?referrer=appbadge&mode=direct"><img src="https://get.microsoft.com/images/en-us%20dark.svg" height="30"/></a>
<a href="https://afdian.com/a/nini22P"><img alt="Afdian" style="height: 30px;" src="https://pic1.afdiancdn.com/static/img/welcome/button-sponsorme.png"></a>
[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/nini22p)

English | [中文](./README_CN.md)

## Features

- [X] Base on [Media Kit](https://github.com/media-kit/media-kit) | [FVP](https://github.com/wang-bin/fvp), supports multiple video formats
- [X] Local storage, WebDAV and FTP support
- [X] Switchable subtitle and audio track
- [X] Playback queue support for random and repeat
- [X] Comprehensive gesture support

## Download

| Platform | Arch/Channel      | Download Link                                                                                                      | Notes                  |
| :------- | :---------------- | :----------------------------------------------------------------------------------------------------------------- | :--------------------- |
| Windows  | **Microsoft Store** | [Microsoft Store](https://apps.microsoft.com/detail/9NML7WNHNRTJ)                                                  | **Recommended**, auto-updates |
|          | Installer         | [IRIS-windows-installer.exe](https://github.com/nini22P/iris/releases/latest/download/IRIS-windows-installer.exe)     |                        |
|          | Portable          | [IRIS-windows.zip](https://github.com/nini22P/iris/releases/latest/download/IRIS-windows.zip)                       | Unzip and run          |
| Android  | arm64-v8a         | [IRIS-android-arm64-v8a.apk](https://github.com/nini22P/iris/releases/latest/download/IRIS-android-arm64-v8a.apk)     | For 64-bit devices     |
|          | armeabi-v7a       | [IRIS-android-armeabi-v7a.apk](https://github.com/nini22P/iris/releases/latest/download/IRIS-android-armeabi-v7a.apk) | For 32-bit devices     |
|          | x86_64            | [IRIS-android-x86_64.apk](https://github.com/nini22P/iris/releases/latest/download/IRIS-android-x86_64.apk)           | For emulators/x86 devices |

## Keyboard and Gesture Controls

### Keyboard Controls

| Key                    | Description                                        |
| ---------------------- | -------------------------------------------------- |
| `Space`              | Play / Pause / Select file                         |
| `Arrow Left`         | Fast backward                    |
| `Arrow Right`        | Fast forward                    |
| `Arrow Up`           | Volume up                                          |
| `Arrow Down`         | Volume down                                        |
| `Ctrl + Arrow Left`  | Previous                                           |
| `Ctrl + Arrow Right` | Next                                               |
| `Ctrl + X`           | Shuffle                                            |
| `Ctrl + R`           | Repeat                                             |
| `Ctrl + V`           | Video zoom                                         |
| `Ctrl + M`           | Volume mute                                        |
| `S`                  | Subtitles and audio tracks                         |
| `P`                  | Play queue                                         |
| `F`                  | Storages                                           |
| `Ctrl + O`           | Open file                                          |
| `Ctrl + L`           | Open link                                          |
| `Ctrl + C`           | Close currently media file                         |
| `Ctrl + H`           | Play history                                       |
| `Ctrl + P`           | Settings                                           |
| `+`                  | Step forward                                       |
| `-`                  | Step backward                                      |
| `Enter`              | Enter full screen / Exit full screen / Select file |
| `F11`                | Enter full screen / Exit full screen               |
| `Esc`                | Exit current Menu / Go back / Exit full screen     |
| `F10`                | Toggle always on top                               |
| `Alt + X`            | Exit application                                   |

### Gesture Controls

| Gesture                           | Description                   |
| --------------------------------- | ----------------------------- |
| Tap                               | Select an item or open a menu |
| Double tap center                 | Play / Pause                  |
| Double tap left side              | Fast backward                |
| Double tap right side             | Fast forward                  |
| Swipe left / right                | Adjust playback progress      |
| Swipe up / down on left side      | Adjust screen brightness      |
| Swipe up / down on right side     | Adjust device volume          |
| Long press                        | Display Playback Speed Selector |
| Long press and swipe left / right | Adjust speed playback speed   |

## Contribution

Contributions of any kind are welcome! If you have suggestions, bug reports, or want to add new features, please submit an [issue](https://github.com/nini22P/iris/issues) or directly submit a Pull Request.

## Sponsorship

If you like this project and want to support me, you can sponsor me through the following platforms:

- [Afdian](https://afdian.com/a/nini22P)
- [Ko-fi](https://ko-fi.com/nini22p)

Thank you for your support!

## License

This project is licensed under the MPL-2.0 license. For more details, please see the [LICENSE](./LICENSE) file.