Tool XLibrary - Advanced Game Library Manager for F95Zone

[Detsu Kai]

Another interesting feature, a small but nice detail, is displaying a count of how many games are being shown.

Hi! Great idea, I've added it to the roadmap

 

[Detsu Kai]

This:

View attachment 5393588

I got it now, but this is dynamic data that will rarely sync with the application (only during game version updates). If you believe this approach is fine, I’ll consider implementing it

 

[Detsu Kai]

Hey, just found your tool and are implementing (some of) the games I played. Tool looks very convenient, I like it so far. But (of course ^^) I have already some suggestions:

Hi! First of all - thank you for this big review!)

- Why does the "Latest:" Version always have a "v" in front of the number? Like in "v0.3.2". Even the games that only have the number on the F95 webpage without the letter. It would be nice if I didn't have to add the "v" to the front of all "My Version:" fields. It's minor, but I have a long list of games to add, so if I just could copy paste the number from my txt file that I currently use to track my progress, then that would be nice.

You are not obligated to add it; it's just a placeholder recommendation

- Also add an easy way to change My Version to the Current status. A button next to it or something like that would be great.

This was released but broken for now, I will fix it

- Closing the game page with the x on the upper right is the only way to get back to the main menu. But it scrolls up together with the rest and then disappears. Would be nice if you could fix it in place, so that it is always visible. And maybe change it to an arrow. At first I thought it would close the whole window.

If I make it sticky, it will consume the limited free space that's already quite small, but I will think about it. And don't forget that you can close any window by pressing the Escape button (I ensure it is functional and comfortable throughout the entire project)

- Oh, and why does the x that actually closes the window only appear when I am in the main menu? If that x would be always visible regardless of where I am in the app, that would be nice.

Makes sense, I'll add it to the todo list

- Apart from that I only would wish for it to automatically add the correct .exe to the launcher. Or even better: I tell the app where I store my porn game collection and it compares the file names with the games on F95, adds matches to the apps list, adds the .exe and then lists every game/folder that it didn't find a match for, so that I could add them manually. Don't know how difficult that would be and how accurate the folders would have to be named, but RenPy games have often the same structure. Finding those starting files should be manageable. And for the rest it's mostly the only .exe in the folder. I think you already have something similar in the "Planned Features". If I understand what you mean with "Download location selection" correctly. Or does it just mean, that every game is downloaded to the same folder?

This feature is still under consideration and may not be implemented. The main issue is that it's very difficult to reliably match games by folder names - zip files and folder names often don't correspond to the F95 game titles at all, and even in rare cases when they do match, they're rarely exactly the same. Such functionality would frequently fail and cause more frustration than actual help. I don't want to implement something that would be more annoying than useful.

- Copy and paste with left mouse button menu would be nice.

You can use Ctrl+C/Ctrl+V for now, but I'll think about adding a context menu.

- Automatically changes between "In Progress" and "Waiting for Update" when I change My Version so that it matches with the current one or back when a newer version is published.

I don't think automatic status changes would work well here - your status reflects your intention (waiting for next update vs currently playing), not just version matching. For example, you could have played the latest available version but it's still a demo or incomplete, so you're waiting for an update. These are independent things.

- When I am in the mask to type in my version, then I can still swipe through the pictures in the background with the left and right arrow buttons. The buttons should only move the cursor of the active field.

Good catch! I'll fix this

- If you do the "automatically read the folders and add them to the app if found in the F95 database", a nice addition would be to also look for .rar/.zip files. As I normally only unpack them when I start playing the game. So most of the games I have on my pc are archives. Because that's how I downloaded them and they take up less space in that state. So seeing those names, reading the version number and adding it to the app's list would be great.

Same issue as mentioned before - matching by file names is unreliable. However, I'm planning to add automatic extraction functionality in the future, which would handle this properly. Until then, working with archives remains problematic.

- A big thing that is missing: "Played Version", "Installed Version" and "Newest Version". "My Version" isn't enough. I often have played Version 0.2, but installed on my PC is Version 0.3. I rarely play the installed Version right after downloading. But if a new version is published before I can start, then that installed version is not my played version. It would be easier to track if I could have the "My Version" changed to Played and Installed.

I don't see the need to separate "played" and "installed" versions - if you installed a game, it becomes your played version. That's the whole point of installing it. The current "My Version" field represents both installed and played version, while "Latest Version" shows what's available. This covers the use case without unnecessary complexity.

- I would suggest to either paint the labels in the Library in different colors or exchange them entirely with the symbols that you use on the individual game pages. A purple triangle for "In Progress" or an orange pause sign for "Waiting for Update", for example. Know with the one to three words with the same colored label it's not as easy to differentiate them as it could be with distinct colors/signs.

Could you clarify which labels you're referring to? Are you talking about the game status labels (In Progress, Waiting for Update, etc.) or something else?

What happens if a game disappears from F95? Does it continue to exist in your app as long as I have the data stored locally? Or does it update at some point and delete the entry with my progress?

Games are never deleted unless you manually remove them, and your progress is always preserved. If a game disappears from F95, you can add another source, remove the F95 provider, or just leave it as is - everything will continue to work fine.

- An option to always open the links in inkognito mode if I click "Open in Browser".

I'll try to implement this, but can't promise - different browsers have different flags for incognito mode, so it might be tricky to make it work universally.

- When I manually add a game, then there are three values that behave not correctly: The "Version" does nothing. I only can type in my version, but not the current version of the game. The field doesn't even appear. Then "Engine" and "Status with the same mistake: They appear as they should on the info page. But when I click the "Edit" button, then those values are empty and if I don't add them back, then they disappear on the info page. So if I only want to change the version or add screenshots, then this two details will disappear after I click "Save Changes".

Thanks for catching these bugs! I'll fix them.

- An option to add local pictures from your pc to a (manual) game. Some webpages only show images when logged in. So XLibrary can't see and grab them.

I'll think about it, but this would be very inconvenient - users would expect such pictures to be saved and restored with backups, but that's not feasible as backups would become gigabytes in size. So this feature is unlikely to be implemented. However, nothing stops you from uploading the needed images to imgur and using those links.

 

[Benji13]

Didn't expect you to go through all of my suggestions ^^
But it shows you care for this project. So thumbs up.

You are not obligated to add it; it's just a placeholder recommendation

View attachment 5401173

Yeah, but the My Version field only turns green, if it matches exactly with the Latest. And can't you use that to search for games that you haven't played up to the latest version? If not, I would suggest it. That would be one of the main benefits for me to quickly see which games I didn't finish.

If I make it sticky, it will consume the limited free space that's already quite small, but I will think about it. And don't forget that you can close any window by pressing the Escape button (I ensure it is functional and comfortable throughout the entire project)

But can't it just be what every other window already have? Most apps have the red x permanently in the right top corner (or left top corner if you use mac). It doesn't even need a whole top line. Just a small x in the corner would be enough. But so that I can easily close the window at any time. I know that you can use the escape button. But I often work and play with only my mouse. I push the keyboard out of way. So doing everything with my mouse feels more natural for me. Plus if I play porn games, my left hand might be busy with other tasks ^^

This feature is still under consideration and may not be implemented. The main issue is that it's very difficult to reliably match games by folder names - zip files and folder names often don't correspond to the F95 game titles at all, and even in rare cases when they do match, they're rarely exactly the same. Such functionality would frequently fail and cause more frustration than actual help. I don't want to implement something that would be more annoying than useful.

I see your point. Would be nice, though. And even if it only works in 5% of the times, it would be convenient. Maybe just write a script that checks the most used ways to name the game file: removing the spaces between words, exchanging them for dots or underscores. Only check if the first xy letters match. The game files and folders often have additional infos at the end. That also could help if the game updates. Then I could only change the [sexy-game-v1] folder with the [sexy-game-v2] folder but it still automatically finds the new .exe file by ignoring the version number.
Or maybe even better: If I add the .exe once, the location is saved. If I then delete the game because I have finished the current version, then it sees, that the location leads to nowhere, but it still has the location. And so every time I open the game overview in XLibrary, it checks if in the location a folder with a similar name (the beginning of the name) is found and automatically changes it to the new location. Or ask if it should change it, so that if two games share a similar or even the same name (already saw that happening) it doesn't connect it to the wrong game.

You can use Ctrl+C/Ctrl+V for now, but I'll think about adding a context menu.

Same reason for with the escape button ^^
I'm doing exactly that, because I have no other option. But I often have my left hand behind my head when I do leisure work. Or you know, the porn reason ^^
So it would be nice having the option to use a context window. Or just this two options left click copies the text, middle button adds the copied text. Something like that. Would be even faster, if you only have those two options in the context window.

I don't think automatic status changes would work well here - your status reflects your intention (waiting for next update vs currently playing), not just version matching. For example, you could have played the latest available version but it's still a demo or incomplete, so you're waiting for an update. These are independent things.

I don't see how that interferes with my idea? If I played up to the latest version, then it should change to "waiting for update". When the game is marked as "complete" and I play to the latest version, then it changes to "played". If A new version is dropped and My Version is not longer the newest, then it changes to "In progress". If I want to have another status, then I always can change it manually. Or have an option to change how it behaves for each individual situation, where I can decide what happens if the version changes to a newer one.

I don't see the need to separate "played" and "installed" versions - if you installed a game, it becomes your played version. That's the whole point of installing it. The current "My Version" field represents both installed and played version, while "Latest Version" shows what's available. This covers the use case without unnecessary complexity.

Well, maybe I can only speak for me, but I have a library of around 300 adult games on my hard drive. Around a fourth I have actually started, the rest is just waiting to be played.
The reason why I would like "played" and "installed" versions to be separate is so that I know which version I already have on my pc and which version I actually played to. Some games I keep on my pc to replay, other are deleted after the game is done. So I don't really know if I have played the version I have on my pc or not. Especially for some older ones. It would help me keep track of what I have on my hard drive.
Or make it also optional. People like me who need more versions tracked can enable them in the settings. Or if you want to go a bit crazy even make it so I can add as many as I want. One version is for the first I played, one for the best version, one for the installed (or all the installed, if I need to have more than one), and so on. I only need played, installed and latest. But maybe someone would appreciate having the option?

Could you clarify which labels you're referring to? Are you talking about the game status labels (In Progress, Waiting for Update, etc.) or something else?

Yes, those labels. They appear on each games left upper corner if you added one. In the main window. But they are all in the same dark red color. So it is not easy to quickly see by scrolling, which game has content (in progress) and which I am waiting for updates. Maybe you could even add the option to have favorite games? Or just a badge that can be added to each game. I would use them to mark those games, that I currently are interested in or am waiting the most for. Or maybe for those that will have an update soon and want to keep in mind. Maybe here also give the option to add several badges? Small pictures would be enough. But in various colors.

Games are never deleted unless you manually remove them, and your progress is always preserved. If a game disappears from F95, you can add another source, remove the F95 provider, or just leave it as is - everything will continue to work fine.

Thanks, that's good to know

I'll try to implement this, but can't promise - different browsers have different flags for incognito mode, so it might be tricky to make it work universally.

As far as I know there are only 3 browsers really. Chromium based ones, Safari for mac users and FireFox. I don't want porn content to appear on my browser history. So for the moment I have to delete the history afterwards. Maybe an option to copy the link to the clipboard instead of opening it straight away could be a good alternative.

I'll think about it, but this would be very inconvenient - users would expect such pictures to be saved and restored with backups, but that's not feasible as backups would become gigabytes in size. So this feature is unlikely to be implemented. However, nothing stops you from uploading the needed images to imgur and using those links.

Yeah, that's what I am did with all the games ^^
Needed the whole day yesterday to download all the images, reuploading them to imgur and one by one add them to XLibrary ^^
I'm glad I only needed to do this with the games not on F95, but yeah. Would be easier to only download them once and add them. And the images are copied to the XLibrary folders, so why is it a problem if I add them from my PC directly? It would be completely ok if they then were copied to those folders as if I added a link. It's even better that way, as they don't take up that much space when converted to WebP.

 

[Detsu Kai]

Yeah, but the My Version field only turns green, if it matches exactly with the Latest. And can't you use that to search for games that you haven't played up to the latest version? If not, I would suggest it. That would be one of the main benefits for me to quickly see which games I didn't finish.

You shouldn't do it manually. In the UI, we have a "Set to Latest" button, but due to a bug, it’s not working right now. I will fix it in the next release.

But can't it just be what every other window already have? Most apps have the red x permanently in the right top corner (or left top corner if you use mac). It doesn't even need a whole top line. Just a small x in the corner would be enough. But so that I can easily close the window at any time. I know that you can use the escape button. But I often work and play with only my mouse. I push the keyboard out of way. So doing everything with my mouse feels more natural for me. Plus if I play porn games, my left hand might be busy with other tasks ^^

I thought you mentioned closing the modal to return to the games list. Now I understand you, and I’ve already implemented it. It will be released in the next version.

I see your point. Would be nice, though. And even if it only works in 5% of the times, it would be convenient. Maybe just write a script that checks the most used ways to name the game file: removing the spaces between words, exchanging them for dots or underscores. Only check if the first xy letters match. The game files and folders often have additional infos at the end. That also could help if the game updates. Then I could only change the [sexy-game-v1] folder with the [sexy-game-v2] folder but it still automatically finds the new .exe file by ignoring the version number.
Or maybe even better: If I add the .exe once, the location is saved. If I then delete the game because I have finished the current version, then it sees, that the location leads to nowhere, but it still has the location. And so every time I open the game overview in XLibrary, it checks if in the location a folder with a similar name (the beginning of the name) is found and automatically changes it to the new location. Or ask if it should change it, so that if two games share a similar or even the same name (already saw that happening) it doesn't connect it to the wrong game.

I believe you can achieve this with GPT by writing a script that parses your folders and prepares them for import into XLibrary. I might implement this functionality in the future, but if you want to use it now, this is the fastest solution. You can fill one game with launcher config and export json file to see how it works inside and implement .exe file detecting too. Structure is really easy

Same reason for with the escape button ^^
I'm doing exactly that, because I have no other option. But I often have my left hand behind my head when I do leisure work. Or you know, the porn reason ^^
So it would be nice having the option to use a context window. Or just this two options left click copies the text, middle button adds the copied text. Something like that. Would be even faster, if you only have those two options in the context window.

Wait this in the next release

I don't see how that interferes with my idea? If I played up to the latest version, then it should change to "waiting for update". When the game is marked as "complete" and I play to the latest version, then it changes to "played". If A new version is dropped and My Version is not longer the newest, then it changes to "In progress". If I want to have another status, then I always can change it manually. Or have an option to change how it behaves for each individual situation, where I can decide what happens if the version changes to a newer one.

Okay I will think about it

Well, maybe I can only speak for me, but I have a library of around 300 adult games on my hard drive. Around a fourth I have actually started, the rest is just waiting to be played.
The reason why I would like "played" and "installed" versions to be separate is so that I know which version I already have on my pc and which version I actually played to. Some games I keep on my pc to replay, other are deleted after the game is done. So I don't really know if I have played the version I have on my pc or not. Especially for some older ones. It would help me keep track of what I have on my hard drive.
Or make it also optional. People like me who need more versions tracked can enable them in the settings. Or if you want to go a bit crazy even make it so I can add as many as I want. One version is for the first I played, one for the best version, one for the installed (or all the installed, if I need to have more than one), and so on. I only need played, installed and latest. But maybe someone would appreciate having the option?

Well, maybe I can only speak for me, but I have a library of around 300 adult games on my hard drive. Around a fourth I have actually started, the rest is just waiting to be played.
The reason why I would like "played" and "installed" versions to be separate is so that I know which version I already have on my pc and which version I actually played to. Some games I keep on my pc to replay, other are deleted after the game is done. So I don't really know if I have played the version I have on my pc or not. Especially for some older ones. It would help me keep track of what I have on my hard drive.
Or make it also optional. People like me who need more versions tracked can enable them in the settings. Or if you want to go a bit crazy even make it so I can add as many as I want. One version is for the first I played, one for the best version, one for the installed (or all the installed, if I need to have more than one), and so on. I only need played, installed and latest. But maybe someone would appreciate having the option?

I will think about it

Yes, those labels. They appear on each games left upper corner if you added one. In the main window. But they are all in the same dark red color. So it is not easy to quickly see by scrolling, which game has content (in progress) and which I am waiting for updates. Maybe you could even add the option to have favorite games? Or just a badge that can be added to each game. I would use them to mark those games, that I currently are interested in or am waiting the most for. Or maybe for those that will have an update soon and want to keep in mind. Maybe here also give the option to add several badges? Small pictures would be enough. But in various colors.

Alright, I'll think about implementing it if I can figure out a good way to ensure a great UI. For favorite just use Favorite tag

As far as I know there are only 3 browsers really. Chromium based ones, Safari for mac users and FireFox. I don't want porn content to appear on my browser history. So for the moment I have to delete the history afterwards. Maybe an option to copy the link to the clipboard instead of opening it straight away could be a good alternative.

Wait in the next release

Needed the whole day yesterday to download all the images, reuploading them to imgur and one by one add them to XLibrary ^^
I'm glad I only needed to do this with the games not on F95, but yeah. Would be easier to only download them once and add them. And the images are copied to the XLibrary folders, so why is it a problem if I add them from my PC directly? It would be completely ok if they then were copied to those folders as if I added a link. It's even better that way, as they don't take up that much space when converted to WebP.

Images in xlibrary are just cached files, meaning they can be cleared at any moment and cannot be recovered. If you delete your local images or switch to another computer, downloading a backup or syncing with Google will leave your library with empty image placeholders. It’s far better to invest some time now in properly transferring your data. In the future, when adding new games, saving directly to Imgur instead of local files won’t take noticeably more time, making the process just as convenient

 

[MyNameIsPalpaterare]

I got it now, but this is dynamic data that will rarely sync with the application (only during game version updates). If you believe this approach is fine, I’ll consider implementing it

I believe that, given how easy it is to add games here and how visually appealing the interface is, many members might start using this tool to organize games they plan to play or install later. Honestly, the “watched” system doesn’t work very well for that purpose.


I used to save game links as browser favorites, but that wasn’t practical either. Your tool, on the other hand, is much more visual, convenient, and functional for this kind of use.


That said, if this limitation means the rating would only sync when the game gets updated on the forum, it might not be that useful, since many users keep completed games in their library that rarely get updates.


But if the sync happens when a game is added as installed, then I think it’s still worth implementing.


I don’t really understand the technical challenges involved, but maybe there’s an alternative approach — for example, a filter or sorting option in the “Downloads” or “Latest Games” section that only shows titles already added to the user’s XLibrary. That way, the site’s own “sort by rating” function could still be used, just narrowed down to the user’s interests.

 

[Detsu Kai]

Hi there! Release is here!
(sorry I forgot to include sorting by community rating, I will implement it in the next release)

1.12.1
- Added: F95Zone community rating now displayed in game cards and game details
- Added: Games counter in catalog showing filtered/total games
- Added: Option to always open links in incognito/private mode
- Added: Context menu for copying text and working with input fields throughout the app
- Added: Update check history with detailed statistics and logs for all manual and scheduled checks
- Added: Automatic game synchronization - automatically sync games with updates or missing data in background
- Added: Auto-sync history with detailed logs showing all sync attempts, success/failure status, and retry information
- Improved: Notifications moved to top-right corner
- Improved: Completion status badges now use color-coded backgrounds matching the status selector
- Improved: Window title bar now always visible above all modals for easy window management
- Improved: Game modal close button moved to left side of title as back arrow for better navigation
- Improved: Auto-sync now fully autonomous - automatically detects games needing sync without manual intervention
- Fixed: Latest version now displays correctly in version editor
- Fixed: Version editor no longer shows "or select" divider when no options available
- Fixed: Resolved errors when opening game modal
- Fixed: Arrow keys now only move cursor in input fields instead of switching screenshots
- Fixed: Engine and Status fields now properly retain values when editing games
- Fixed: Version field now works correctly for manually added games
- Fixed: Game modal now closes automatically when game is deleted from browser extension
- Fixed: Game sources now properly sync and update version information for all providers

1.12.0
- Added: Steam as a supported game source with automatic updates
- Added: Extension automatically detects if game is already in library under different name
- Added: Manual search in library with real-time search as you type
- Added: Add game sources to existing games directly from browser extension
- Added: Redesigned UI for add game window on F95Zone and other platforms