# Sora
> Also known as Sulfur due to copyright considerations.

<div align="center"> 

<img src="https://raw.githubusercontent.com/cranci1/Sora/refs/heads/main/assets/Sulfur.png" width="750px">

[![Build and Release IPA](https://github.com/cranci1/Sora/actions/workflows/build.yml/badge.svg)](https://github.com/cranci1/Sora/actions/workflows/build.yml) [![Discord](https://img.shields.io/discord/1293430817841741899.svg?logo=discord&color=blue)](https://discord.gg/XR3SrmUbpd) [![Platform](https://img.shields.io/badge/Platform-iOS%20%7C%20iPadOS%2015.0%2B%20%26%20macOS%2012.0%2B-red?logo=apple&logoColor=white)](https://img.shields.io/badge/Platform-iOS%20%7C%20iPadOS%2015.0%2B%20%26%20macOS%2012.0%2B-red?logo=apple&logoColor=white)

**An iOS and macOS modular web scraping app, under the GPLv3.0 License.**

</div>

## Table of Contents

- [Features](#features)
- [Installation](#installation)
- [Frequently Asked Questions](#frequently-asked-questions)
- [Acknowledgements](#acknowledgements)
- [License](#license)
- [Legal](#legal)

## Features

- [x] macOS 12.0+ support
- [x] iOS/iPadOS 15.0+ support
- [x] JavaScript as main loader
- [x] Download support (HLS & MP4)
- [x] Tracking services (AniList, Trakt)
- [x] Apple Keychain support for auth tokens
- [x] Streams support (Jellyfin/Plex-like servers)
- [x] External metadata providers (TMDB, AniList)
- [x] Background playback and Picture-in-Picture (PiP) support
- [x] External media player support (VLC, Infuse, Outplayer, nPlayer, SenPlayer, IINA, TracyPlayer)

## Installation

You can download Sora using Xcode or using the .ipa file, which you can find in the [Releases](https://github.com/cranci1/Sora/releases) tab or the [Nightly](https://nightly.link/cranci1/Sora/workflows/build/dev/Sulfur-IPA.zip) build page.

## Frequently Asked Questions

1. **What is Sora?**  
   Sora is a modular web scraping application designed to work exclusively with custom modules.

2. **Is Sora safe?**  
   Yes, Sora is open-source and prioritizes user privacy. It does not store user data on external servers and does not collect crash logs.

3. **Will Sora ever be paid?**  
   No, Sora will always remain free without subscriptions, paid content, or any type of login.

4. **How can I get modules?**  
   Sora does not include any modules by default. You will need to find and add the necessary modules yourself, or create your own.

## Acknowledgements

Frameworks:
- [Drops](https://github.com/omaralbeik/Drops) - MIT License
- [NukeUI](https://github.com/kean/NukeUI) - MIT License
- [SoraCore](https://github.com/cranci1/SoraCore) - Custom License
- [MarqueeLabel](https://github.com/cbpowell/MarqueeLabel) - MIT License

Misc:
- [50/50](https://github.com/50n50) for the app icon
- [Ciro](https://github.com/CiroHoodLove) for the episodes banners

## License

This project is licensed under the [GNU General Public License v3.0](LICENSE) (GPLv3.0).

```
Copyright © 2024-2025 cranci. All rights reserved.

Sora is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Sora is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Sora. If not, see <https://www.gnu.org/licenses/>.
```

## Legal

**_Sora is not intended for piracy. The Sora project does not endorse or support any form of piracy._**

### No Liability

The developer(s) of this software assume no liability for damages, legal claims, or other issues arising from the use or misuse of this software or any third-party modules. Users bear full responsibility for their actions. Use of this software and its modules is at your own risk.

### Third-Party Websites and Intellectual Property

This software is not affiliated with or endorsed by any third-party entities. Any references to third-party sites in user-generated modules do not imply endorsement. Users are responsible for ensuring their scraping activities comply with the terms of service and intellectual property rights of the sites they interact with.

### DMCA

The developer(s) are not responsible for the misuse of any content inside or outside the app and shall not be held liable for the dissemination of any content within the app. Any violations should be reported to the source website or module creator. The developer bears no legal responsibility for any module used within the app.