movie-web/README.md

68 lines
2.6 KiB
Markdown
Raw Normal View History

2022-02-17 18:28:23 +01:00
2023-11-30 19:40:23 +01:00
<p align="center"><img align="center" width="280" src="./.github/logo-dark.svg#gh-dark-mode-only"/></p>
<p align="center"><img align="center" width="280" src="./.github/logo-light.svg#gh-light-mode-only"/></p>
<p align="center">
2023-11-30 19:40:23 +01:00
<img src="https://skillicons.dev/icons?i=react,vite,ts" />
<br/>
2024-02-26 22:27:31 +01:00
<a href="https://movie-web.github.io/links/discord"><kbd>🔵 discord</kbd></a> <a href="https://movie-web.github.io/docs"><kbd>🟢 docs</kbd></a>
</p>
2023-11-30 19:40:23 +01:00
<br/><br/>
2021-08-02 13:45:22 +02:00
2023-11-30 19:40:23 +01:00
# ⚡What is movie-web?
movie-web is a web app for watching movies easily.
2021-08-02 13:45:22 +02:00
2023-01-29 18:53:14 +01:00
This service works by displaying video files from third-party providers inside an intuitive and aesthetic user interface.
2023-11-30 19:40:23 +01:00
# 🔥Features
2022-02-17 18:28:23 +01:00
2023-11-30 19:40:23 +01:00
- Automatic saving of progress - optionally synced to an account.
- Bookmark shows or movies, keep track of what you want to watch.
- Minimalistic interface that only shows whats required - no algorithm to consume you.
2021-07-21 12:19:59 +02:00
2023-11-30 19:40:23 +01:00
## 🍄 Philosophy
2022-05-01 21:25:27 +02:00
2023-11-30 19:40:23 +01:00
This project is meant to be simple and easy to use. Keep features minimal but polished.
We do not want this project to be yet another bulky streaming site, instead it aims for minimalism.
2022-05-01 21:25:27 +02:00
2023-11-30 19:40:23 +01:00
On top of that, hosting should be as cheap and simple as possible. Just a static website with a proxy, with an optional backend if you want cross-device syncing.
2022-12-27 15:56:28 +01:00
2023-12-28 15:05:59 +01:00
Content is fetched from third parties and scraping is fully done on the client. This means that the hoster has no files or media on their server. All files are streamed directly from the third parties.
2022-12-27 15:56:28 +01:00
2023-11-30 19:40:23 +01:00
## ⚠️ Limitations
2022-12-27 15:56:28 +01:00
2023-11-30 19:40:23 +01:00
- Due to being a static site, there can be no SSR
- To keep it cheap to host, amount of proxied requests need to be kept to a minimum
- Also to keep it cheap, no content must ever be streamed through the proxy. So only streams not protected by CORS headers.
2022-02-17 18:28:23 +01:00
2023-11-30 19:40:23 +01:00
# 🧬 Running locally for development
2021-07-21 12:19:59 +02:00
2023-11-30 19:40:23 +01:00
To run locally, you must first clone the repository. After that run the following commands in the root of the repository:
```bash
2023-09-01 15:27:55 +02:00
pnpm install
pnpm run dev
2021-07-21 12:19:59 +02:00
```
2022-02-17 18:28:23 +01:00
You have to also make an `.env` file to configure your environment. Inspire it from the content of `example.env`.
2023-11-30 19:40:23 +01:00
To build production files, run:
```bash
pnpm build
```
2022-05-02 14:54:42 +02:00
2023-11-30 19:40:23 +01:00
> [!TIP]
2023-11-30 19:48:31 +01:00
> You must use pnpm (`npm i -g pnpm`) and run NodeJS 20
2022-02-17 18:28:23 +01:00
2023-11-30 19:51:55 +01:00
# 🥔 Selfhosting
2023-11-30 19:40:23 +01:00
A simple guide has been written to assist in hosting your own instance of movie-web. Check it out below
|[Selfhosting guide](https://movie-web.github.io/docs)|
2023-11-30 19:40:23 +01:00
|---|
2022-12-27 17:33:30 +01:00
2023-12-30 03:39:19 +01:00
## 🤝 Thanks to all Contributors
2023-12-30 13:02:45 +01:00
This project would not be possible without our amazing contributors and the community. Thanks a lot! Keep rocking 🍻.
2023-12-30 03:39:19 +01:00
[![Contributors](https://contrib.rocks/image?repo=movie-web/movie-web)](https://github.com/movie-web/movie-web/graphs/contributors)