Skip to main content
This page collects answers to the most common questions about installing, configuring, and troubleshooting Lampac Ukraine modules. If your question is not covered here, check the configuration reference or open an issue on GitHub.
Lampac identifies each module by its internal module name, not by the human-readable provider name. All Lampac Ukraine modules use the LME. prefix (Lampac Modules Extended) to avoid collisions with Lampac’s built-in modules.If you use "Uaflix" as the key, Lampac will not recognise it and the module will not load. You must use the exact module name as the key:
"LME.Uaflix": {
  "enable": true,
  ...
}
The same rule applies to every module in this collection: LME.AnimeON, LME.Bamboo, LME.Mikai, LME.KlonFUN, and so on.
Yes. When using auto-install via repository.yaml, the modules field is optional. If you omit it, Lampac installs every module in the repository. If you include it, Lampac installs only the modules you list:
- repository: https://github.com/lampac-ukraine/lampac-ukraine
  branch: main
  modules:
    - LME.AnimeON
    - LME.Mikai
For manual installation, simply copy only the module folders you want into your Lampac module/ directory.
The two settings control different phases of the request lifecycle:
  • useproxy routes the module’s content parsing and page fetching through the configured proxy. This affects the requests Lampac makes to the source site when looking up titles, episodes, and player embeds.
  • streamproxy routes the actual video stream through a proxy. This affects what URL the client receives for playback — the stream URL is rewritten so that the video traffic flows through the proxy rather than directly from the player CDN.
You can enable either or both independently. A common setup is to enable useproxy when the source site blocks your server’s IP, and enable streamproxy when the client device cannot reach the player CDN directly.
webcorshost redirects the module’s HTTP parsing requests through a CORS proxy host. This is useful when the Lampac server needs to fetch content from a source that enforces browser-style CORS restrictions.It does not conflict with streamproxy because they handle different traffic:
  • webcorshost applies to parsing requests (fetching source pages and player embeds).
  • streamproxy applies to stream URLs delivered to the playback client.
You can combine webcorshost with useproxy as well — webcorshost handles CORS for parsing while useproxy routes that same parsing traffic through a proxy for IP-level access.
magic_apn is a per-module setting that rewrites Ashdi stream URLs through a configurable reverse-proxy template before returning them to the client. It is specifically for Ashdi (ashdi.vip) links and has no effect on other providers.Configure it with an ashdi key whose value is a proxy URL template containing the {encodeurl} placeholder:
"magic_apn": {
  "ashdi": "https://tut.im/proxy.php?url={encodeurl}"
}
When the module resolves an Ashdi stream URL, it URL-encodes the original stream address and substitutes it into the template. The client receives the proxy URL instead of the direct ashdi.vip URL.Use this when your client devices cannot reach ashdi.vip directly — for example, when the client is on a network that blocks the domain or when you want to route Ashdi streams through your own reverse proxy. Leave the value null or omit the field to use Ashdi URLs directly.
Yes. The domain field lets you override the default source domain for a module. This is useful in two situations:
  1. The official domain has changed. Ukrainian streaming sites sometimes migrate to new domains. You can update domain in init.conf without waiting for a module update.
  2. You want to use a mirror. If the primary domain is blocked on your network, point domain at an accessible mirror.
"LME.Uaflix": {
  "domain": "https://uaflix.net",
  ...
}
The module uses whichever URL you provide here for all its requests.
Use the one-liner below to download check.sh from the repository and run it immediately. You need curl and wget available on the host:
wget -O check.sh https://raw.githubusercontent.com/lampame/lampac-ukraine/main/check.sh && sh check.sh
The script checks whether each source page is reachable, detects which player provider is embedded, and probes each provider for a live stream URL. Results are printed in two report sections. See the check script reference for full details on interpreting the output.
Auto-install via repository.yaml requires Lampac 148.1 or newer. On older versions, you must install modules manually by cloning the repository and placing the module folders into your Lampac module/ directory.To use auto-install, create or update module/repository.yaml with the repository URL and the list of modules you want:
- repository: https://github.com/lampac-ukraine/lampac-ukraine
  branch: main
  modules:
    - LME.Uaflix
    - LME.AnimeON
Lampac will then fetch and install the listed modules on startup.
LME.JackTor is not a streaming site module — it is a bridge between Jackett and TorrServer. Instead of fetching content from a Ukrainian streaming site, it queries Jackett to search torrent indexers by title, filters results by quality, codec, audio language, and seeder count, then passes the selected torrent to a TorrServer instance for direct playback.Key differences from other modules:
  • Requires a running Jackett instance with an API key.
  • Requires one or more TorrServer nodes configured in torrs or auth_torrs.
  • Supports quality filtering (quality_allow), HDR mode, codec selection, and per-language audio preference.
  • Can search Ukrainian trackers such as Toloka as well as international ones.
Use LME.JackTor alongside streaming modules to provide a torrent-based fallback for titles that are unavailable or low-quality on streaming sources.
checksearch is a special operational mode used by Lampac’s search refinement feature. When Lampac calls a module in checksearch mode, the module does not return a full list of streams — instead, it verifies whether the requested content actually exists on that source and returns a validation marker.Lampac uses this to avoid presenting sources in search results when the content is not available on them, reducing noise in the UI. You do not need to configure checksearch manually; Lampac triggers it automatically when needed.

Build docs developers (and LLMs) love