
<h1 align="center">
  <br>
    <a href="https://github.com/Fladder-App/Fladder"><img src="https://github.com/Fladder-App/Fladder/blob/develop/icons/fladder_macos_icon.png?raw=true" alt="Fladder" width="200"></a>
  <br>
  Fladder
  <br>
</h1>

<h4 align="center">A Simple Jellyfin Frontend built on top of <a href="https://flutter.dev/" target="_blank">Flutter</a>.</h4>

<p align="center">
  <a href="#key-features">Key Features</a> •
  <a href="#screenshots">Screenshots</a> •
  <a href="#planned-features">Planned Featuress</a> •
  <a href="#download">Download</a> •
  <a href="#how-to-contribute">Contributing</a> •
  <a href="#credits">Credits</a> •
  <a href="#license">License</a>
</p>

## Key Features

* Play media – Stream or sync content locally to your device.
* Manage your library – Refresh content and edit metadata.
* Multiple profiles – Lock profiles and connect to different servers.
* Direct/Transcode playback
* Intro/Credits skipping
* Trickplay support (timeline scrubbing)
* Dark/Light mode
* Simple book reading support
* Sync supported on Mobile/Desktop
* Platforms
  - Android - Web - macOS - Windows
  - iOS working but no way to deploy/publish
  - Linux ready for testing
 
## Screenshots
<details close>
  <summary>Mobile</summary>
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Mobile/Dashboard.png?raw=true" alt="Fladder" width="200">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Mobile/Details_2.png?raw=true" alt="Fladder" width="200">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Mobile/Favourites.png?raw=true" alt="Fladder" width="200">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Mobile/Library.png?raw=true" alt="Fladder" width="200">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Mobile/Resume_Tab.png?raw=true" alt="Fladder" width="200">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Mobile/Sync.png?raw=true" alt="Fladder" width="200">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Mobile/Player.png?raw=true" alt="Fladder" width="1280">  
</details>

<details close>
  <summary>Tablet</summary>
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Tablet/Dashboard.png?raw=true" alt="Fladder" width="1280">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Tablet/Details.png?raw=true" alt="Fladder" width="1280">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Tablet/Settings.png?raw=true" alt="Fladder" width="1280">  
   <img src="https://github.com/Fladder-App/Fladder/blob/develop/assets/marketing/screenshots/Tablet/Sync.png?raw=true" alt="Fladder" width="1280">    
</details>

Web/Desktop [try it out!](https://fladder-app.github.io/Fladder)

## Planned Features

* Music playback
* Android TV
* Server management
* And more???

## Download

The latest release can be found [here](https://github.com/Fladder-App/Fladder/releases).

## How to Contribute

Interest in contributing? Here are a couple of ways you can help:

### 🐛 Reporting Bugs
- Before reporting a bug, **please ensure** that the issue hasn't been reported already.
- When submitting a bug report, provide detailed steps on how the bug can be reproduced. This will help us to understand and fix the issue faster.
- Bug reports are appreciated and very helpful!

### 🚀 Submitting Pull Requests
- **Pull requests are always welcome!** 
- For new features or large changes, please open a discussion or issue first to ensure that no one else is already working on it.
- **Keep pull requests short and focused**: try to avoid fixing multiple issues in a single pull request. This helps make the review process smoother and quicker.

Thank you for helping to make this project better! 🙌


## Credits

This software uses the following open source packages:
- [Flutter](https://flutter.dev/)

## License

GNU General Public License v3.0


