Souvenarium
Souvenarium brings together your films, series, videos, photos, comics and channels in your own media library. The library is empty on first launch: no content or subscription is provided.
Favorites and watchlist per profile
Each profile has two personal lists: My favorites keeps titles even after viewing; Watchlist removes them once seen, and keeps a series until all of its current episodes have been viewed. The categories explain this difference next to each heading. Use the heart or bookmark on a cover, or the buttons on the card, to add or remove a title. A temporarily unavailable source keeps your lists. Lists are local to each device; synchronized progress from a NAS profile also removes titles that have become seen.
Choose your version
| System | File | Installation |
|---|---|---|
| Android and Fire TV | APK | Android 7 or higher; Fire OS 6 or higher on APK-enabled devices |
| Windows x64 | EXE installer | Installation for logged in user |
| Windows x64 | Portable ZIP | Extract the entire ZIP then launch souvenarium.exe |
| macOS 12+ · Apple Silicon and Intel | ZIP | Move Souvenarium.app to Applications |
| Linux | Coming soon | No Linux binaries are currently released |
Stable is the current version. Beta allows you to test the next version before its promotion.
Browse published versions for this format, with their date, size and release notes. The header buttons offer the latest Stable and Beta versions regardless of the filters. Sign in to download; Doc opens the installation instructions. Only versions that are still published appear in this list.
Android: install with account Souvenarium
All release files require a login to account Souvenarium. Log in in the device browser before using APK links. In the application, the session of the connected account (by classic connection or API key) authenticates version reads and downloads.
- Open the browser on your device and connect to Souvenarium.
- Enter
https://www.souvenarium.com/stable.apkfor the Stable APK, orhttps://www.souvenarium.com/beta.apkfor the Beta APK. - Start the download with your account connected.
- Open the file
.apk, then choose Install. - If prompted by the device, allow browser apps to be installed in the Android or Fire TV settings.
- Open Souvenarium and add your sources.
All possible URLs are:
| Channel | With www | Without www |
|---|---|---|
| Stable | https://www.souvenarium.com/stable.apk | https://souvenarium.com/stable.apk |
| Stable | https://www.souvenarium.com/last | https://souvenarium.com/last |
| Beta | https://www.souvenarium.com/beta.apk | https://souvenarium.com/beta.apk |
| Beta | https://www.souvenarium.com/lastbeta | https://souvenarium.com/lastbeta |
Favor the prefix https://. Tools like Downloader must have a valid account session; a single URL does not allow any downloads.
The links return the APK file after account authentication, with support for download resumption. They all follow the app and version chosen by the admin for their channel, including a fixed version. The extension .apk in the address is an alias; the name of the downloaded file retains its version.
Windows: installer
Sign in to your Souvenarium account to download a file.
- Download the installer Stable or Beta, après connexion à votre compte Souvenarium.
- Launch the EXE file and follow the wizard. From Beta 0.1.57, Windows requires administrator rights to also install the service.
- Open Souvenarium from the Start menu.
| Channel | With www | Without www |
|---|---|---|
| Windows Stable | https://www.souvenarium.com/lastw | https://souvenarium.com/lastw |
| Windows Beta | https://www.souvenarium.com/lastbetaw | https://souvenarium.com/lastbetaw |
In the Settings of the Windows application, the card Update displays the installed version and available versions. Stable version and
Beta version open the installer download .exe in the browser. Then open the downloaded file to install the update. The installer finds the existing catalog, profiles and settings.
On startup, Souvenarium checks the available versions in the background. A small arrow on the settings wheel indicates an update. In the card Update, Skip this version memorizes the Stable and Beta versions displayed and hides the reporting until a next version.
Both links support download resumption. The administrator independently chooses the application and version of each Windows channel: automatic or fixed. Android targets maintain their own settings. The public page /windows presents the installation and the channels.
Windows: provisioning service
From Beta 0.1.57, the setup installs SouvenariumService. Open Settings → Service, then Install the service, after connection to the account which must make the media available. This activation automatically creates an API key and a separate device. The service starts with Windows and allows exchanges when the application is closed.
The service uses the same locations, folders, settings and the same local SQLite database as the desktop. Configuration changes are transmitted via authenticated local communication. Secrets are kept in a protected Windows vault. Network drive letters mounted only in your Windows session may be inaccessible to the service; then use an SMB location with its saved credentials.
Once the service is configured, the application deactivates its own provisioning and outgoing exchanges to avoid duplicates. Playback, downloads and other interface functions remain available. Even if you change accounts in the interface, the service continues with the account associated with its API key. A revocation of this key or its device interrupts its exchanges.
The Service page allows you to start, restart or stop the service, and to finish by force its process after confirmation if necessary. Stopping the service suspends provisioning until the next time the service starts. The green icon indicates that it is started and operating normally. When the application is launched, then in the background, a control indicates problems with a red marker on Settings button. This page is for Windows only.
Windows: portable version
- Download the portable ZIP.
- Extract everything the ZIP in a writable folder.
- Launch
souvenarium.exe. Keep the filedataand all DLLs next to the program.
Add your collection
From Beta 0.1.59, open Settings → My Sources to find Streaming Sites, Folders and Locations. The Interface and Journals cards also group their sections together; The preview cache is in Library and Caches.
Open them Settings, then the Locations and Folders. Add a folder from your PC, a NAS in SMB, a disk, a URL or a playlist depending on your source. Choose the categories to display: films, series, videos, photos, comics and television.
Covers, metadata, and progress remain in your catalog when your NAS is temporarily inaccessible. Reconnect the source and restart playback.
Media search
The welcome magnifying glass opens the search. Enter a comic title, file name or author using the keyboard, touch or remote control.
The search accepts forgotten accents, plurals in S, doubled letters, apostrophes, added or forgotten spaces, inverted words and confusions O/0, I/l and S/5. French articles are optional. Thus, “the origin” can find “the origin”, and “prof” can find “profs” or “le prof”. The years and episode numbers remain distinct.
Two out of three matching words are enough to display a result. Each word found counts once. A match score out of 100 appears under the covers and places the best results first. For the same score, the titles with the fewest words, then the shortest, come first. The results respect the chosen category and the age of the profile.
Folders containing films and series
When adding or modifying a Films or Series folder, check
This directory can contain films and series to enable automatic classification. The detector examines file names, markers like S01E02 or 1x02, files S01, S1, S2, Saison 1
and neighboring files. A film saga remains a collection of films: a common title is not enough to transform it into a series.
In Unclassified, the cards offer Detection (Auto, Films, Series) and Your choice (Auto, Films, Series, Other). The user choice has priority over detection, then over the folder category. Other classifies the file as a personal video, without searching for information online.
A new full scan updates the detection and classification of files to Auto. Forced user choices, manual corrections, favorites and progress remain retained. Physical files are not moved. An uncertain case takes up the category of the file; unknown seasons and episodes do not receive made-up numbers.
Playing on a TV with Cast
In the player, tap the Cast icon then choose the TV's Google Cast or DLNA receiver. The phone and television must be on the same local network. The phone then acts as a remote control and keeps progress. Stop casting Resumes local playback at the last known position.
The relay chooses the network to reach the television and announces the type of media, including for a NAS URL without extension. Connection, loading and decoding errors display their available cause. A television offering Google Cast and DLNA may appear twice: you can try its other receiver. The television must know how to decode the file; the phone does not perform transcoding.
Profiles and playback
Create your profiles in Settings. Each profile keeps its progressions and can have an age to filter known classifications. Tap the portrait to change profiles.
On remote control, use the arrows to move the focus, Okay to activate and Return to return. On Windows, the keyboard and mouse remain available.
Update
Install a new version with the same package type. Do not erase your data to perform an update. Android installations retain the same signing certificate as previous versions.
Under Windows and for an Android APK installation, Souvenarium checks the Stable and Beta channels at startup. A small arrow on the button Settings indicates that a newer version than the one installed is available. Open the card Update to view the versions and download the version of your choice.
The single button Skip this version ignores the displayed Stable and Beta versions together. The arrow disappears until a next version is published in one of the two channels. The choice remains memorized after restart for all profiles of this device; you can always download a version from settings. If the connection fails, the application starts normally. Android installations from a store use updates from that store.
Check a download
The file card provides its fingerprint SHA-256. Compare it to that of the received file if you want to verify its integrity. Example under Windows: Get-FileHash chemin-du-fichier -Algorithm SHA256.
Connect a NAS to your customer account
On the site, open My APIKeys and systems and create a key with a name, description and its activation dates. Both days are included, in UTC. Copy the key when creating it: it is displayed only once.
In the NAS PHP site, open Connect, enter this APIKey sc_…
and click Connect. The status confirms the connection or explains the problem. The name and description defined in Settings go back to your account. Each system maintains its identity during reconnections.
The Play/Pause icon on the key allows you to suspend or reactivate your connections. The list shows systems that are online, offline, disconnected, or blocked by an inactive key. Disconnect central side requires a new connection from the NAS. Media access keys sv_… remain available in
Access keys NAS for applications.
In native PHP, schedule tool/central-heartbeat.php every minute with the same PHP and user as the site to maintain its presence when the browser is closed. After three minutes of no contact, it appears offline.
macOS: install the Beta
Extract the ZIP and move Souvenarium.app to Applications. This Beta is not notarized by Apple; the guide explains how to allow it to open in Privacy & Security.
After the first attempt to open the app, allow only Souvenarium in System Settings → Privacy & Security → Open Anyway, then confirm Open. No developer mode or global security changes are needed.
To update the app, quit Souvenarium and replace Souvenarium.app in Applications. Your saved catalog and credentials are preserved.