Repository navigation
Releases
v1.2.0.0
Added
- Resolve Only First Link: New option to resolve only the direct URL of the opened item, ignoring sibling versions and slow paths for faster start.
- Configurable Sibling Limit: Added
EnableSiblingLimittoggle and customizableMaxSiblingsPerOpen(1-20) for background quality discovery. - Configurable Concurrency Limit: Added
EnableMaxConcurrentResolutionsand expandedMaxConcurrentResolutionsrange to 1-20 to prevent rate-limiting from Chomikuj. - Fast Resolution Path: Made opt-in (
falseby default) with automatic fallback to classic method on failure. - UI Overhaul & Cleanup: Reorganized settings into logical sections (Credentials, Storage, Playback, Cleanup, and Status) and hid
UseFastResolvePathalias from the UI via[Browsable(false)]. - Tests: Added tests for
ResolveOnlyFirstLinkand configurable concurrency limit (74/74 passing).
v1.1.0.0
This release focuses on code quality, thread safety, and regression testing. No new features were added, but the plugin is now more robust and professional than ever.
Quality Improvements
- 0 Compiler Warnings: Fixed CS4014 and CS0649.
- Thread-Safe File Reads:
AssignStrmFileNamesnow uses the sharedAtomicFilelock to prevent reading half-written.strmor.originalfiles during sync. - GitHub Actions (CI): Added
.github/workflows/ci.ymlto automatically build and run all tests on every push. - Regression Tests: Added 3 new unit tests (72 total) covering episode regex variations (
1x01,T1E1), flat layouts, and.originalorphan cleanup.
Bug Fixes
- Fixed orphan cleanup not detecting
.originalfiles when the.strmwas missing. - Improved episode sibling resolution for series with different naming conventions.
v1.0.1.0
🚀 Improvements
- Series Sibling Resolution: Now supports formats like
1x01,T01E01,S01E01, and flat layouts. It also avoids mixing different series and orders results deterministically. - Orphan Cleanup: The plugin now detects and removes orphaned
.originalfiles when their corresponding.strmhas been deleted (respecting DryRun mode).
v1.0.0.0
This is the first stable, production-ready version of the Chomyfin plugin.
🚀 Key Highlights
- Network Share Support (SMB/NFS): Implemented a safe fallback for atomic writes on network file systems, preventing synchronization failures on NAS (Synology, Unraid, etc.).
- Technical Debt Cleanup (P2): Safe exception handling (
StrmGeneratorAbortException), per-instance diagnostic counters, and safe ID parsing (TryParse). - Final UI/UX: Clean English interface and display of the last sync status.
🛡️ Security and Stability (Carried over from v0.9.x)
- Elimination of session cookie leaks.
- REST endpoint protection (Admin only).
- Fail-safe log sanitizer.
- Protection against accidental deletion (Orphans DryRun enabled by default).
- Atomic writes and background sibling resolution.
v0.9.3.0-beta
Changelog
All notable changes to this project will be documented in this file.
[v0.9.3.0] - 2026-11-01
Security Audit (P0/P1)
- Cookies Removed: Removed sensitive session cookies and credential exposure in logs and client responses.
- Admin Endpoints: Secured all sensitive plugin API endpoints, restricting access strictly to Emby administrators.
- Sanitizer: Hardened path traversal and filename sanitizer against malicious or crafted folder/file names.
- Orphans DryRun: Introduced dry-run protection mode for orphan file deletion to prevent unintended media loss.
- Atomic Writes: Implemented atomic writes for generated
.strmfiles using temporary files and atomic replacement to prevent file corruption during sync. - Background Sibling Resolution: Offloaded sibling item resolution and remote calls to asynchronous background tasks, preventing UI thread blocking and sync stalls.
UI
- Hardcoded English UI: Transitioned configuration interface to clean, hardcoded English (removed i18n resources to resolve persistent Emby dashboard caching glitches).
- Last Sync Status: Added a read-only "Last Sync Status" indicator at the bottom of the plugin configuration page.
Migration Notes
- CustomScanPath: Users must review and re-enter
CustomScanPathif migrating from earlier versions. - OrphansDryRun: Please review the
OrphansDryRunsetting in configuration; verify orphan items before disabling dry-run mode.
0.9.0.0-beta
Chomyfin v0.9.0.0 — Release Notes
This update is the result of a thorough security and stability audit. 4 critical vulnerabilities (P0) and 6 important bugs (P1) have been resolved. The plugin is now much safer, faster, and will no longer block video playback.
Security (P0)
- Session cookies removed from the player: Chomikuj cookies are no longer sent to Emby or playback clients (preventing session leaks in ffmpeg logs). It has been verified that direct URLs work without them.
- REST Endpoints protected: Routes to force sync, check status, or test connections now require the Admin role.
- Fail-safe log sanitizer: The system masking passwords and tokens in logs is now bulletproof (supports JSON, URLs, and truncated XML). The last two lines of code printing unencrypted data have been patched.
- Protection against accidental deletion: Orphan file deletion is now strictly limited to the folders scanned by the plugin. Additionally, a safe mode (
OrphansDryRun) has been added, which is enabled by default.
Stability & Performance (P1)
- Name collision resolved: If you have
Movie.mkvandMovie.mp4, the plugin will now generateMovie.strmandMovie [mp4].strminstead of overwriting each other on every sync. - Atomic writes:
.strmand.originalfiles are now written safely using temporary files. Emby will never read a half-written file. - Instant playback: Sibling version resolution has been moved to a background thread (fire-and-forget). It no longer delays video startup.
- Sibling queue throttling: Concurrency is limited to 1 to avoid saturating the Chomikuj API. A purge system was added to prevent memory leaks.
- Unstuck syncs: Fixed an execution lock leak. If a scan fails at startup, the plugin will no longer get stuck saying "A generation is already in progress".
- Real cancellation: If you cancel a sync from Emby, it now shows as "Canceled" (previously it was marked as an error).
- Robust login: Timeouts are no longer confused with actual cancellations. Concurrent requests share a single login session (preventing Chomikuj rate-limits/bans).
MIGRATION NOTES (Must Read)
Due to the security and stability changes, there are three behavioral changes compared to v0.8.7.0:
- Orphan deletion is in simulation mode (
DryRun).- For safety,
OrphansDryRunis enabled by default. If you had orphan deletion enabled, you will see[ORPHANS-DRYRUN] N .strm would be deletedin the logs, but nothing will actually be deleted. - What to do: Check the logs. If you agree with what would be deleted, go to the plugin settings and uncheck "Orphans: simulate only (dry-run)".
- For safety,
- Scan paths reset.
- The
SelectedFoldersproperty has been renamed toCustomScanPathto fix a UI bug. If you had selected folders, you will need to re-enter them in the plugin settings.
- The
- New
.strmfiles due to collisions.- If you had two remote files with the same name but different extensions, new entries will appear in Emby (e.g.,
Movie [mp4].strm). Old.strmfiles will not be deleted, but a clean library scan is recommended.
- If you had two remote files with the same name but different extensions, new entries will appear in Emby (e.g.,
How to update
- Download the new
Chomyfin.dll(v0.9.0.0). - Replace the file in your Emby
/config/plugins/folder. - Restart Emby.
- Go to the plugin settings and re-enter your scan folders.
0.8.7.0-Beta
Chomyfin v0.8.7.0-beta Release Notes
This is the very first Beta release of Chomyfin, an Emby Server plugin designed to seamlessly integrate your Chomikuj.pl library.
This version establishes a solid, functional baseline with advanced resolution features and a robust SOAP scraper before the upcoming security hardening phase.
Added
- SOAP Scraper: Complete integration with the Chomikuj SOAP API to scan your account and generate
.strmfiles recursively. - Sibling Resolution: Asynchronous background queue that resolves alternative versions (e.g., 4K, 1080p) of the same movie/episode without blocking the Emby UI.
- Fast Path Resolution: Intelligent URL resolution that uses the known
fileIddirectly via a single HTTP request, bypassing the HTML download when possible. - Custom Scan Paths: Support for scanning specific folders (e.g.,
/Prywatne/...) instead of the entire account. - Deterministic Media IDs: Uses an MD5 hash of the
.strmfile path to generate stable IDs, preventing Emby from losing track of multiple versions.
Improved
- Dynamic Version Names: Emby's version selector now displays the actual quality and codec (e.g.,
1080p AVC) instead of the generic "Chomikuj Stream". - Manual Task Execution: You can now trigger the
.strmsynchronization manually from Emby's Scheduled Tasks, regardless of whether the automatic scheduler is enabled or disabled. - Robust SOAP Parser: The parser now gracefully handles empty folders (like the account root) and continues scanning without throwing fatal exceptions.
Fixed
- Configuration Persistence: Fixed a critical binding conflict in Emby's UI where the
SelectedFoldersproperty clashed with the enum name, causing the text box to clear on save. Renamed toCustomScanPath. - Root Folder Crash: Fixed an issue where an empty root folder would abort the entire sync process.
Security
- Log Sanitization: Implemented
SoapLogSanitizerto automatically mask tokens, passwords, and sensitive folder credentials in diagnostic logs and dumps.
Note: This is a Beta version. A comprehensive security audit (fixing session cookie exposure and orphan file deletion safeguards) is currently in progress for the v1.0.0 stable release.