docs: update project documentation in README.md

This commit is contained in:
Felix 2026-04-17 17:16:55 +03:00
parent 35c16258f8
commit 94fcbc535e

192
README.md
View File

@ -1,48 +1,57 @@
# Ukraine online source for Lampac NextGen # Lampac Ukraine Modules (`LME.*`)
> **Important:** All modules use the prefix `LME.` (Lampac Modules Extended) to avoid conflicts with Lampac's built-in modules. Набір українських онлайн-модулів для Lampac NextGen.
> Text names, namespaces, keys in `init.conf`, and routes all use the prefix `LME.`. Усі модулі використовують префікс `LME.` (Lampac Modules Extended), щоб уникати конфліктів із вбудованими модулями Lampac.
## Sources ## Навігація
### TVShows and Movies
- [x] LME.Uaflix - [Українська](#ua)
- [x] LME.Makhno - [English](#en)
- [x] LME.StarLight
- [x] LME.KlonFUN
- [x] LME.UafilmME
### Anime and Dorama ## <a id="ua"></a>Українська
- [x] LME.AnimeON
- [x] LME.Bamboo
- [x] LME.Unimay
- [x] LME.Mikai
- [x] LME.NMoonAnime
## Installation ### Доступні модулі
1. Clone the repository: **Фільми та серіали**
```bash - `LME.Uaflix`
git clone https://github.com/lampame/lampac-ukraine.git . - `LME.Makhno`
``` - `LME.StarLight`
- `LME.KlonFUN`
- `LME.UafilmME`
- `LME.JackTor`
2. Move the modules to the correct directory: **Аніме та дорами**
- If Lampac is installed system-wide, move the modules to the `module` directory. - `LME.AnimeON`
- If Lampac is running in Docker, mount the volume: - `LME.Bamboo`
```bash - `LME.Unimay`
-v /path/to/your/cloned/repo/LME.Uaflix:/lampac/module/LME.Uaflix - `LME.Mikai`
``` - `LME.NMoonAnime`
## Auto installation ### Ручне встановлення
If Lampac version 148.1 and newer 1. Клонуйте репозиторій:
```bash
git clone https://github.com/lampame/lampac-ukraine.git .
```
Create or update the module/repository.yaml file 2. Скопіюйте потрібні теки модулів у директорію `module` вашого Lampac.
```YAML 3. Для Docker приклад монтування:
```bash
-v /path/to/lampac-ukraine/LME.Uaflix:/lampac/module/LME.Uaflix
```
### Автовстановлення через `repository.yaml`
Працює у Lampac `148.1+`.
Створіть або оновіть `module/repository.yaml`:
```yaml
- repository: https://github.com/lampame/lampac-ukraine - repository: https://github.com/lampame/lampac-ukraine
branch: main branch: main
modules: modules:
- LME.Shared
- LME.AnimeON - LME.AnimeON
- LME.Unimay - LME.Unimay
- LME.Mikai - LME.Mikai
@ -56,14 +65,16 @@ Create or update the module/repository.yaml file
- LME.JackTor - LME.JackTor
``` ```
branch - optional, default main Важливо:
- `branch` — необов'язково, за замовчуванням `main`.
- `modules` — необов'язково; якщо не вказано, встановляться всі модулі з репозиторію.
- Якщо ви вказуєте конкретний список `modules`, додавайте `LME.Shared`, бо інші модулі підключають спільні файли через `syntaxPaths`.
modules - optional, if not specified, all modules from the repository will be installed ### Налаштування в `init.conf`
## Init support Ключ має збігатися з назвою модуля (`LME.XXX`), а не з назвою провайдера.
> **Note:** The key in `init.conf` must match the module name (`LME.XXX`), **not** the provider name. Приклад для `LME.Uaflix`:
> For example, for Uaflix, use `“LME.Uaflix”`, not `“Uaflix”`.
```json ```json
"LME.Uaflix": { "LME.Uaflix": {
@ -88,16 +99,16 @@ modules - optional, if not specified, all modules from the repository will be in
"magic_apn": { "magic_apn": {
"ashdi": "https://tut.im/proxy.php?url={encodeurl}" "ashdi": "https://tut.im/proxy.php?url={encodeurl}"
} }
} }
``` ```
Parameter compatibility: Сумісність параметрів:
- `webcorshost` + `useproxy`: work together (parsing via CORS host, and network output can go through a proxy with `useproxy`). - `webcorshost` + `useproxy`: працюють разом (парсинг через CORS-хост, мережевий вихід може йти через проксі).
- `webcorshost` does not conflict with `streamproxy`: CORS is used for parsing, `streamproxy` is used for streaming. - `webcorshost` + `streamproxy`: не конфліктують (CORS для парсингу, `streamproxy` для потоків).
- `magic_apn.ashdi` is used only for Ashdi links and only when the value is not empty. - `magic_apn.ashdi` використовується лише для Ashdi-посилань і лише коли значення не порожнє.
- `webcorshost` does not conflict with `magic_apn`: CORS is used for parsing, while `magic_apn` is used for Ashdi streaming. - `webcorshost` + `magic_apn`: не конфліктують.
## JackTor config example (`init.conf`) ### Приклад конфігурації `LME.JackTor`
```json ```json
"LME.JackTor": { "LME.JackTor": {
@ -159,19 +170,98 @@ Parameter compatibility:
} }
``` ```
Key parameters at a glance: Ключові параметри:
- `jackett` + `apikey`: your Jackett host and API key. - `jackett` + `apikey`: хост Jackett та API-ключ.
- `min_sid` / `min_peers` / `max_size` / `max_serial_size`: base torrent filters. - `min_sid` / `min_peers` / `max_size` / `max_serial_size`: базові фільтри торрентів.
- `quality_allow`, `hdr_mode`, `codec_allow`, `audio_pref`: quality/codec/language prioritization. - `quality_allow`, `hdr_mode`, `codec_allow`, `audio_pref`: пріоритезація якості, кодека та мов.
- `torrs`, `auth_torrs`, `base_auth`: TorrServer nodes used for playback. - `torrs`, `auth_torrs`, `base_auth`: вузли TorrServer для відтворення.
- `filter` / `filter_ignore`: regex filters for release title and voice labels. - `filter` / `filter_ignore`: regex-фільтри для релізів та озвучок.
## Source/player availability check script ### Скрипт перевірки доступності джерел
```bash ```bash
wget -O check.sh https://raw.githubusercontent.com/lampame/lampac-ukraine/main/check.sh && sh check.sh wget -O check.sh https://raw.githubusercontent.com/lampame/lampac-ukraine/main/check.sh && sh check.sh
``` ```
## Donate ### Підтримка
Підтримати автора: https://lampame.donatik.me
---
## <a id="en"></a>English
### Available modules
**TV shows and movies**
- `LME.Uaflix`
- `LME.Makhno`
- `LME.StarLight`
- `LME.KlonFUN`
- `LME.UafilmME`
- `LME.JackTor`
**Anime and dorama**
- `LME.AnimeON`
- `LME.Bamboo`
- `LME.Unimay`
- `LME.Mikai`
- `LME.NMoonAnime`
### Manual installation
1. Clone the repository:
```bash
git clone https://github.com/lampame/lampac-ukraine.git .
```
2. Copy required module folders into Lampac `module` directory.
3. Docker mount example:
```bash
-v /path/to/lampac-ukraine/LME.Uaflix:/lampac/module/LME.Uaflix
```
### Auto installation via `repository.yaml`
Requires Lampac `148.1+`.
Create or update `module/repository.yaml`:
```yaml
- repository: https://github.com/lampame/lampac-ukraine
branch: main
modules:
- LME.Shared
- LME.AnimeON
- LME.Unimay
- LME.Mikai
- LME.NMoonAnime
- LME.Uaflix
- LME.Bamboo
- LME.Makhno
- LME.StarLight
- LME.KlonFUN
- LME.UafilmME
- LME.JackTor
```
Notes:
- `branch` is optional, default is `main`.
- `modules` is optional; if omitted, all repository modules are installed.
- If you specify an explicit module list, include `LME.Shared` because other modules use shared files through `syntaxPaths`.
### `init.conf` key rule
Use module name (`LME.XXX`) as a key, not provider name.
Example: `LME.Uaflix` instead of `Uaflix`.
### Source/player availability check script
```bash
wget -O check.sh https://raw.githubusercontent.com/lampame/lampac-ukraine/main/check.sh && sh check.sh
```
### Support
Support the author: https://lampame.donatik.me Support the author: https://lampame.donatik.me