Scenerixx manual

Note: if you are watching this help in the internal browser of Scenerixx the links might not work. Better open it in an external browser (you find it under /scenerixx/help/help.html).
  1. Quickstart for the very impatient
  2. Quickstart for the impatient
  3. Getting Started
    1. Installation
    2. Requirements
      1. VLC
      2. MediaInfo
      3. FFmpeg
    3. Use MySql instead of an embedded database
    4. Useful things to know
    5. What's next?
  4. Available windows
    1. Movies
      1. Search
      2. Search by ID
      3. Contextmenu for the root node
        1. New movie
        2. Reload
        3. Recalculate total runtime for all movies
      4. Contextmenu for the movie nodes
        1. Open Movie
        2. Open Movie (looped)
        3. Mark as favorite
        4. Add To Default Playlist [Playlistname]
        5. Add To Playlist
        6. Open Directory
        7. Export Movie
        8. Add Scene
        9. Add n scenes to movie
        10. Add Bookmark
        11. Reset Counter
        12. Delete movie from database
        13. Delete movie & files from disc
        14. Recreate screencap(s)
        15. Copy screencaps to source folder
        16. Delete screencap
        17. Remove mediumfile from movie
        18. Remove picture from movie
        19. Swap medium files
        20. Mark as 'No Duplicate'
        21. Prefix movie title
        22. Confirm wizard data
        23. Set Studio
        24. Add Person
        25. Add Movie Type
      5. Contextmenu for the scene nodes
        1. Open Scene
        2. Open Scene (looped)
        3. Add To Default Playlist [MyPlaylist]
        4. Add To Playlist
        5. Delete Scene
        6. Add bookmark to scene
        7. Add n bookmarks to scene
        8. Remove picture from scene
        9. Remove [person]
        10. Swap person
        11. Reset Counter
        12. Reset 'I came' counter
        13. Add person(s)
        14. Add person(s) from clipboard
      6. Contextmenu for the bookmark nodes
        1. Open Bookmark
        2. Open Bookmark (looped)
        3. Add To Default Playlist [MyPlaylist]
        4. Add To Playlist
        5. Delete Bookmark
        6. Add Sub-Bookmark
        7. Add n sub-bookmarks to bookmark
        8. Create GIF
      7. Opening
        1. Open
        2. Fullscreen
        3. Loop
      8. Extra information
        1. Show Counter
        2. Show "I came" counter
        3. Show runtime
        4. Show rating
        5. Show only last X
      9. Ordering
        1. Order by type
        2. Order by title
        3. Order by rating
        4. Order by runtime
        5. Order by last modification
        6. Order by date of shoot
      10. Showing / Hiding
        1. Show all movies
        2. Show only favorites
        3. Show only movies flagged as regrettably awesome
        4. Show playlist
        5. Show / Hide movies where all scenes are associated to a person
        6. Show / Hide movies where all scene lengths are set
        7. Show / Hide movies where a Scenerixx-file exists
        8. Show / Hide movies where scenes are associated
      11. Other
        1. New
        2. Create Intro
    2. Studios
      1. Contextmenu for the root node
        1. Show available Scenerixx-files
        2. Import Studio
        3. Reload
      2. Contextmenu for the studio node
        1. Create Playlist
        2. Export Studio
        3. Delete Studio
    3. Persons
      1. The tree
      2. The buttons
        1. Open
        2. Open Randomized
        3. Create Playlist
      3. Contextmenu for the root node
        1. Show available Scenerixx-files
        2. Import person
        3. Reload
        4. Export All Persons From Database
      4. Contextmenu for the person node
        1. Search medium files containing this name in its filename
        2. Create Playlist
        3. Add To Default Playlist [Playlistname]
        4. Add To Playlist
        5. Reset 'I came' counter
        6. Delete Person
        7. Export Person to public file
      5. Search
      6. Show [xxx]
        1. Show rating
        2. Show runtime
        3. Show Counter (how often you came)
        4. Show Counter (how often a scene was started)
        5. Show Aliases
      7. Show [radiobuttons]
        1. Male
        2. Female
        3. All
        4. Reminds me of
        5. Only Favorites
      8. Order by
        1. Name
        2. Number of appearances
        3. Birthyear
        4. Rating
        5. Runtime
        6. Hair color
        7. Body Type
        8. Tits
        9. Ass
      9. Filter
        1. Show all persons
        2. Show persons where no profile picture at all could be found
        3. Show persons where profile picture is missing
        4. Show persons where nsfw profile picture is missing
        5. Show persons where picture directory is missing
    4. Details
      1. General Details
        1. Cover
        2. Title
        3. Tube movie
        4. Favorite
        5. Highlight
        6. Regrettably Aweseome
        7. Bonus scene
        8. Behind the scenes
        9. Censored
        10. Decensored
        11. Vertical
        12. Mirrored
        13. Secret
        14. Public Description
        15. Private Description
        16. Rating
        17. Immersion
        18. Partner compatibility
        19. Primary Person
        20. Studio
        21. Type
        22. No.
        23. Start-/Endtime
        24. Title/Chapter
        25. Date of shoot
        26. Spoken language
        27. Audio synchronized
        28. Audio desync
        29. Sound / Video Quality
        30. Location
        31. Condoms used
        32. Save
        33. I came
        34. Scene Overview
        35. Current Scene
        36. Gantt chart
      2. Person Details
        1. Credited as
        2. Face Censored
        3. Cuck
        4. Non sex
        5. Mentioned age
        6. Guessed age
        7. Body Type
        8. Fake Tits
        9. Obviousness
        10. Tits Size
        11. Ass Size
        12. Pubic Hair
        13. Hair Length
        14. Hair Color
        15. Hair Style
        16. Hair Type
        17. Makeup
        18. Nails
        19. Dirty Talk
        20. Dirty Talk Intensity
        21. Dominating
        22. Disgusted
        23. Enjoyment
        24. Appearance
        25. Language
        26. Moaning
        27. Screaming
        28. Tits Bouncing
        29. Clothes
        30. Jewelry
      3. Cumshot Details
        1. Rating
        2. Quantity
        3. Position (receiver)
        4. Disgusted (receiver)
        5. Enjoyment (receiver)
        6. Swallow
        7. Cleanup after
      4. Screencaps
      5. Medium Files
        1. The result tree
          1. Used icons
          2. Context menu
        1. Search
        1. Fields
          1. Width
          2. Height
          3. Duration
          4. Part
          5. Rating
          6. Exportlevel
          7. Audio Desync
        2. Type
        3. Hiding
        4. Ordering
        5. Show Duplicates
        6. Other
          1. Show Counter
          2. Show Directory
          3. Start VLC
        7. Creating movies
          1. Create new movie
          2. Create single scenes from selected nodes
          3. Create movies from selected nodes
      6. Search
        1. Managing searches (using a default search, save searches)
        2. Default Search, Reset & Clear
        1. Search options
        2. Number of females
        3. Number of males
        4. Age
        5. Min. rating
        6. Length
        7. Min. Width/Height
        8. [Bookmarktype] yes/no/whatever
        9. Person tree
        10. The result tree
      7. Playlist
        1. Temporary Playlist
        2. Contextmenu for the root node
          1. Reload
          2. New Playlist
        3. Contextmenu for the playlist node
          1. Play
          2. Play randomized
          3. Set as default
          4. Make playlist secret
          5. Rename
          6. Copy files
          7. Export to VLC playlist (*.xspf)
          8. Delete Playlist
        4. Contextmenu for the playlist entry node
          1. Start playlist from here
        5. Deleting several playlists at once
        6. Merging / Copying a playlist into another
      8. Person Details
        1. Profile picture
        2. Fields
        3. Buttons
          1. Download Images
        4. Drop Downs
      9. Studio Details
        1. Fields
        2. Buttons
      10. Indexing, Hashing, Purging
        1. Choose directory for indexing
        2. Start hashing
        3. Purge
        4. Add single file to index
        5. Index DVD
        6. Update mediainformation
        7. Generate Screencaps
        8. Purge Screencaps
        9. Find Duplicates
        10. Bulk Renaming
        11. Wizard
        12. Abort
        13. Import Importfiles
    5. Available menus
      1. File
      2. Scenerixx
      3. Tools
      4. Window
      5. Help
    6. Options Dialog
      1. General
        1. Log Level
        2. Font size
        3. Show last X movies
        4. Show help on startup
        5. Show only favorites on startup
        6. Hide profile pictures in locked mode
        7. Show random profile pictures in unlocked mode
        8. Hide covers in locked mode
        9. Hide screencaps in locked mode
        10. Use Smart Start
          1. Skip Interviews
          2. Skip Story
        11. Always apply "movie types" to scenes when saving a movie
        12. Always apply "date of shoot" to scenes when saving a movie
        13. Search on keypress
        14. Create history playlist entry when a playable is started via a double click on the screencap
        15. Random playlist entries
        16. Tooltip [reshow] delay
        17. Hide 'Tip of the Day' on startup
        18. Check for updates on startup
        19. Change Look & Feel
        20. Password for secured items
        21. Password-protect start
        22. Choose color for highlighting search results
        23. Show XXX functionality
      2. Directories
        1. Export base directory
        2. Profile picture directory
        3. Random profile picture directory
        4. Screencap directory
        5. Playlists directory
        6. Program directories
        7. Download directories
        8. Browser binary
      3. Screencaps
        1. Screencap: single picture dimension
        2. Screencap: Pictures per column
        3. Screencap: Pictures per row
        4. Generate screencap for scenes
      4. Scenerixx Hub
        1. Port
        2. Start at startup
      5. Wizard
        1. A scene is considered up to x minutes
        2. Prefix movie title with directory name
        3. Apply tags
        4. Play sound after Wizard finished
        5. Max. number of characters that a filename might diff from the directory to consider it part of a multi file movie
        6. Max. number of files in a directory to take it into consideration for a multi file movie
      6. GIF
        1. Where should the GIFs be stored?
        2. How many frames per seconds should the GIF have.
        3. The width of the GIF
      7. Backups
        1. Where should backups be stored?
        2. How many backups should be kept?
  5. Scenerixx Hub
  6. Scenerixx VLC Bridge
  7. FAQ
    1. First things first: why?
    2. Which operating systems are supported?
    3. Error: Cannot find Java 1.8 or higher
    4. The font sucks, can I change it?
    5. There is a window missing.
    6. Which data Scenerixx will collect and what will happen with them?
    7. An error occurred - What should I do?
    8. How to get new data / importfiles?
    9. How to update Scenerixx?
    10. How to uninstall Scenerixx?
    11. Where is the database stored and how to backup?
    12. Where are the log-files stored?
    13. Which file types are supported?
    14. Why can you specify several person body data?
    15. What are ignore bookmarks?
    16. What are differentiators for? (The dropdown with "+ = -")
    17. About "date of shoot" / "production dates"
    18. What should I do if a movie split over several filed opens in the wrong order?
    19. Why is there always another person shown at startup?
    20. What are secrets
    21. Secrets & Playlists
    22. Secrets & Persons
    23. Profile pictures
    24. Studio logos
    25. What is "Audio desync"?
    26. Tracking of deleted files
    27. Why can't the application gather any information on it's own?
    28. After several hundred movies the program gets really slow. What can I do?
    29. How to re-arrange the windows?
    30. How to get in touch (because of bugs, feature requests, data, general feedback, etc.)?
    31. Japanese and other 'strange' characters in filenames are not displayed correctly. Why?
    32. Some look & feels display a heart / star after a node some not
    33. Under Linux VLC does not start. Why?
    34. VLC does not start anymore
    35. How to contribute?
    36. Donations
  8. Changelog
  9. Roadmap, Known Issues & TODOs
    1. Known Issues
    2. Roadmap

Quickstart for the very impatient

For the very impatient among us, here is the most brief overview you can get:

  1. Make sure that the requirements are met and start Scenerixx.
  2. Open the " Indexing, Hashing, Purging"-window and execute the Scenerixx Wizard.
  3. While you are waiting for the wizard to finish (depending on the size of your collection this might take a few hours, for me it takes about an hour for ~500 movies) you might want to skim a bit through the documentation. You should at least read the quickstart for the impatient.
  4. Have fun

Quickstart for the impatient

For the impatient among us, here a very brief overview of what your first steps should be:

  1. Make sure that the requirements are met and start Scenerixx.
  2. Open the " Indexing, Hashing, Purging"-window where you index and hash the folders you want to. If you have MediaInfo already installed, update also the media information by clicking the button.
  3. Switch to the " Movies"-window, right-click on the root-node and add a new movie.
  4. Switch to the " MediumFiles"-window, search for the files that belongs to the newly created movie, select them and drag & drop them on the movie in the movie-window. After dropping the files the " Details"-window automatically opens.
  5. Fill out the basic data and save.
  6. Switch to the " Person Details"-window and create all necessary persons. If you want to associate a picture to the person drag&drop a picture file from the " MediumFiles"-window to a person in the " Persons"-window. (You might need to move one of the windows by clicking on their tab and drag it somewhere else so that you can see both windows at the same time).
  7. Switch to the " Persons"-window and drag&drop the persons to the corresponding scenes. (You can select multiple persons if you press CTRL while clicking).
  8. Select a scene () in the " Movies"-window and fill out the details in the " Details"-window. Save and repeat for the other scenes.
  9. Right click on a scene to add bookmarks.
  10. Select a bookmark and fill out the details in the " Details"-window. Save and repeat.
  11. Complement the data and create a new Studio (right click on root node in the " Studios"-window and fill out the data in the " Studio Details"-window) which you assign in the " Details"-window after selecting a movie.
After that you can:

Getting started

Installation

1.) Make sure you have at least Java 17 or newer installed.
If you are not sure if you have the correct version installed, open a console window and type:

            java -version

If Java is installed something like this should be printed on the screen:

    openjdk version "17.0.6" 2023-01-17
    OpenJDK Runtime Environment (build 17.0.6+10-Ubuntu-0ubuntu120.04.1)
    OpenJDK 64-Bit Server VM (build 17.0.6+10-Ubuntu-0ubuntu120.04.1, mixed mode, sharing)

If the command is not found or the version is below 17.0.0 you need the Adoptium OpenJDK or Oracles JRE.


2.) After you verified that Java is installed on your computer you need to extract the archive to a directory of your choice and start Scenerixx with the executable that you can find the "bin" directory.

Requirements

Scenerixx is based on the NetBeans platform and therefore needs at least Java 17 or newer to run. Download it from Oracle or the open source variant OpenJDK.
It depends heavily on three other open source programs: VLC, MediaInfo and FFmpeg. You can use Scenerixx without them but with a lot of restrictions.
If you run Scenerixx on Windows you are asked if you want to download those programs if they are not found.

VLC

VLC is used as the player to open your video files. Since a lot of features (like bookmarks) use VLC specific command line parameters it's not possible to choose another player as the default player.
You can download it from http://www.videolan.org/vlc/.

MediaInfo

MediaInfo is used to determine video length and resolution.
You can download it from https://mediaarea.net/en/MediaInfo.
IMPORTANT: You must download the CLI version and NOT the GUI one.

FFmpeg

FFmpeg is used to create screencaps from your videos.
You can download it from https://www.ffmpeg.org/.

Use MySql instead of an embedded database

Scenerixx stores all data in an embedded HSQLDB database. If you have no clue what that means or you don't care, you don't have to do anything.
If you want you can also let Scenerixx store the data in a MySql (or MariaDB) database. For that you have to create a property-file with the name {user.directory}/scenerixx/mysql.conf and create the database with this SQL-statement:
CREATE DATABASE `scenerixx` /*!40100 COLLATE 'utf8_unicode_ci' */;

The tables will be created with the first start of Scenerixx.

An example mysql.conf would look like this (starting with version >3.5.0):

jakarta.persistence.jdbc.driver=com.mysql.cj.jdbc.Driver
jakarta.persistence.jdbc.user=user
jakarta.persistence.jdbc.password=password
jakarta.persistence.jdbc.url=jdbc:mysql://localhost:3306/scenerixx?zeroDateTimeBehavior=convertToNull&characterEncoding=UTF8&useSSL=false

Up to version 3.5.0 you needed something like this:
javax.persistence.jdbc.driver=com.mysql.cj.jdbc.Driver
javax.persistence.jdbc.user=user
javax.persistence.jdbc.password=password
javax.persistence.jdbc.url=jdbc:mysql://localhost:3306/scenerixx?zeroDateTimeBehavior=convertToNull&characterEncoding=UTF8&useSSL=false
Change the values accordingly.

Useful things to know

Some things you should have heard once and do not fit somewhere else:

What's next?

If you haven't read the quickstart yet, do it now. Or, if you are a thorough person, keep on reading to explore the full potential of Scenerixx.


Available windows


Movies

The tree

The tree contains your movies and can have nodes up to four levels deep:

        Root
        ├─ Movie
        |   ├─ Scene 
        |   |  ├─ Bookmark
        |   |  |  ├─ Subbookmark
        |   |  |  ├─ Subbookmark
        |   |  ├─ Bookmark
        |   |  ├─ Bookmark
        |   ├─ Scene 
        ├─ Movie

You can open several items at once by pressing CTRL+Enter.

With a double-click you can open scenes and bookmarks (looped). A double-click on a movie expands the node.

You can reduce the results in the tree by providing a searchterm in the searchbox above the tree which needs to be included in the movie title. With CTRL+Space you can trigger a auto completer to show you previous search terms (needs at least two characters).

Bookmarks can be re-ordered via drag&drop.

Scenes can be re-ordered via drag&drop.

If you cannot decide for yourself: there are two buttons to randomly select a node (CTRL+R) or to randomly open a scene (ALT+R).

To associate a mediumfile to a movie switch to the " MediumFiles"-window, search for the files that you want to associate, select them and drag & drop them on the movie in the movie-window. You can select more than one file if you hold CTRL while clicking on the file. If more than one file is dropped to the movie, Scenerixx will use the same order in which you selected the file.
E.g.: you have the files a, b and c. You click first on b, then a, then c and drop them on a movie. Scenerixx will open the files in the order b, a, c. Have a look at the FAQ how to fix wrongly ordered files.
After dropping the files the " Details"-window automatically opens..

To associate a person to a scene switch to the " Persons"-window and drag&drop the persons to the corresponding scene. You can select multiple persons if you press CTRL while clicking.
If more than one person is dropped Scenerixx will sort them alphabetically, first the females, then the males.

Search

You can narrow down the list by using the search field. Fields that are considered for the search:

If you want to exclude a search term prefix it with two dashes (--).

If your search term(s) contains spaces you can escape them with quotes.

Let's assume we have a movie with the title "Tori-Black.mp4".
Consider now following search term: Tori Black
This would find the movie title because the search don't care where a search term is found.
Would we search for: "Tori Black"
the search would not come up with the title because the search term cannot be found exactly in the movie title.

Search by ID

Sometimes you have an ID of a movie / scene / bookmark that you want to open directly. You can do this if search for the ID with a prefixed hashtag:

So depending what you have (a movie / scene / bookmark) you need to prefix the ID with one, two or three hashtags.
IMPORTANT: there must be no space between hashtag and ID.
Another thing to consider: you cannot search for movies that start with a hashtag.

Used icons for the movie node
Used icons for the scene node
Used icons for the bookmark node
Contextmenu for the root node
Contextmenu for the movie nodes
Contextmenu for the scene nodes
Contextmenu for the bookmark nodes

Opening

Open
Opens the selected node(s) (at the correct position if a starttime is provided). As a shortcut you can use CTRL+Enter.
Fullscreen
Specifies if VLC should be opened in fullscreen.
Loop
If this checkbox is checked, VLC will loop the selected node(s) infinitely (if start-/endtime is provided).

Extra information

You can let Scenerixx show additional information for each node.
If the production date and the birthdate of the person is known, Scenerixx will display the age of the person behind its name. If only the years are known Scenerixx will make an approximation (signaled via a tilde (~) before the age).
Note: If you are having a lot of movies this might slow down the performance since Scenerixx needs to execute a database query for each node for each additional information.
Show Counter
Shows (in square brackets after the title) how often a node was started. There's a counter for each type (movie, scene, bookmark, sub-bookmark).
Show "I came" counter
Shows (in square brackets after the title) how often you pressed the "I came" button. Applies only to scenes, bookmarks and sub-bookmarks.
Show runtime
Shows (in square brackets after the title) the duration if it's known. Unknown durations will be displayed as [00:00:-1]
Show rating
Shows (in square brackets after the title) the rating if it's known.
Show only last X
Shows only the last X created movies. This becomes useful if you have already several hundred movies in the database and the UI slows down when creating new movies. X can be configured in the options.

Ordering

Defines the order of the tree nodes:
Order by type
Orders the movies by the predefined types. Type is used as a synonym for categories here. Movies which are not associated to a type will show up under "Undefined".
Order by title
Orders the movies alphabetically. This is the default ordering.
Order by rating
Orders the movies by rating.
Order by runtime
Orders the movies by their runtime. Longest movies first. If you choose this ordering the checkbox "Show runtime" will automatically be selected (and cannot be unselected until another ordering is selected).
Order by last modification
Orders the movies by their last modification. Newest first. Every time you are changing some data the last modification date is updated.
Order by date of shoot
Orders movies by their release. Newest first. Unknown release dates will be at the end of the list.

Showing / Hiding

Show all movies
Default. Don't hide anything.
Show only favorites
Show only movies that are marked as favorites.
Show only movies flagged as regrettably awesome
Show only movies that are marked as regrettably awesome.
Show playlist
Show only movies that are on a specified playlist. This can be especially useful if you executed "Find Duplicates" before and want to clean up.
Show / Hide movies where all scenes are associated to a person
[Hiding] Shows only movies where at least one scene is not associated to any person. This can be helpful to find out where persons are still missing.
Show / Hide movies where all scene lengths are set
[Hiding] Shows only movies where at least for one scene no start-/endtime is provided (and therefore cannot be started directly).
Show / Hide movies where a Scenerixx-file exists
[Hiding] Shows only movies which don't have already an scenerixx export file.
Show / Hide movies where a scenes are associated
[Hiding] Shows only movies which don't have at least one scene associated.

Other

New
Creates a new movie. The same functionality as adding a movie via the contextmenu of the root-node.
Create Intro
Creates an intro bookmark for the selected movie. This is just a shortcut and UI-wise absolutely ugly at the moment.

Studios

The term studio is here broadly defined and includes beside studios websites if they provide original content.

If you select a studio in the tree, details to this studio will be automatically loaded in the " Studio Details"-window.

You can merge studios via drag & drop.

Contextmenu for the root node
Contextmenu for the studio node

Persons

Shows all persons that are available in the database. After the very first start only a few placeholder persons are available (and which also cannot be deleted).
Following colors are used to distinguish persons:

The tree

Each node is a person. Sub-nodes are the scenes this persons appears in. If you click on a scene the corresponding movie will be selected in the movie-window. Behind the person name the number of appearances is displayed in square brackets.

You can associate a person to a scene by dragging&dropping a person to a scene in the "Movies "-window.

You can merge persons via drag & drop.

The buttons

Open

Opens all movies from the selected persons. As an alternative press CTRL+Enter.

Open Randomized

Opens all movies from the selected persons and play them in a random order. Shortcut is ALT+R.

Create Playlist

Create a playlist with all movies from all selected persons.

Contextmenu for the root node
Contextmenu for the person node /

Search

You can narrow down the available persons in the tree by providing some search terms in the search input field. A person have to match only one of the search terms. For example: if you type in "ash gianna james" the tree might be narrowed down to: "James Deen", "Gianna Michaels", "Ashlynn Brooke" and "Sasha Grey".
You can also comma separate terms where each search term group has to be included in the name, e.g.: "paul james ford" would normally result in something like "Paulina James, Alan Stafford, James Deen, Alexis Ford, Brenda James"
Using a comma ("paul james, ford") would result in:
"Paulina James, Alan Stafford, Alexis Ford"
Instead of a comma you can also use an ampersand (&) as a delimiter.
This comes handy if you are searching for several people and want to reduce noise in the search result.

With CTRL+Space you can trigger a auto completer to show you previous search terms (needs at least two characters).

Show [xxx]

Show [radiobuttons]

Order by

Filter

Each person can have a profile picture. Scenerixx distinguishes three types of profile pictures. A default one, a nsfw profile picture and a directory which can contain several pictures that are shown at random.
The filter helps you to find persons without a profile picture:

Details

The details window let's you edit movies, scenes and bookmarks. The form is context sensitive and might vary depending on the selected entity.

General Details

Cover

Pictures can be dragged&dropped from the "Medium Files"-window to movies, scenes and bookmarks. If a picture is associated to an entity it will be displayed at the top of the form. If more than one picture is associated to an entity you can cycle the pictures by clicking on it.
You can configure if covers should be shown in the options.
If you want to change the order the pictures are displayed have a look at the FAQ.

Title

New movies always will have the name "[New Movie]". As soon as you added some medium files to the newly created movie Scenerixx automatically fills the title field with the filename of the first added file.
You can (and should) change the title. A few notes on how I imagine how the title should look like:

If the selected entity is a scene the title cannot be changed and will be assembled in the following form: Scene [x] of movie [movie title] - [persons in the scene]
If the selected entity is a bookmark you can leave the title empty or provide an optional description. If a description is provided it will be shown for bookmarks nodes next to the bookmarktype.

Favorite

A flag to mark a movie as a favorite. Makes it easier to find your favorites later on without using any playlists.

Highlight

A flag to mark a bookmark as a highlight.
Even though every bookmark can be marked as a highlight it is more meant for "custom"-type bookmarks which again are meant to be sub-bookmarks of a specific bookmark.
It is meant for little personal highlights like for example a facial expression, a moaning or an eye-rolling.

    Scene                   (00:00 - 32:18)
    |-> Bookmark Cowgirl    (23:04 - 25:39)
        |-> Bookmark Custom (24:19 - 24:21) <- this is the highlight bookmark
Bookmarks that are marked as a highlight are represented in the tree with a diamond ().

Regrettably Aweseome

Do you know those scenes that makes you on the on hand feel ashamed and on the other hand you really enjoy them? This is the right flag for those.

Tube movie

If you select this checkbox two new textfields will be shown:

The URL can be any website that you want. If you later open a tube movie, Scenerixx will just opens this URL in an external browser. You can laster associate a medium file to a tube movie in which case Scenerixx would open the local medium file.

The title can be the title that is used on the website. For some tube sites Scenerixx will already parse the title on its own after the "Tube-url"-textfield lost its focus. The title is saved separately because sometimes the titles are so ridiculously long that they won't fit into filename.

In some cases a "Download" button is shown next to the "Save" button. In this case Scenerixx knows how to download the video from the tube site and saves them under "${user}/scenerixxdownloads" or the directory that you specified in the options. After the download is finished Scenerixx will add the file to the index, hash it and associates it with the movie. Scenerixx would now start the local file instead of opening a browser.

IMPORTANT: if you are opening later a scene or a bookmark it is not guaranteed that they will get opened at the right position. Scenerixx can pass the parameter for the timestamp to a chosen few tube sites but not to all. In this case Scenerixx would just open the tube site and the movie would start from the beginning.

Bonus scene

[Only available for scenes] If the selected scene is a bonus scene.

Behind the scenes

[Only available for scenes] If the selected scene is a "Behind the scenes"-scene.

Censored

[Only available for movies] If you are into asians you know the dilemma: they shoot some of the kinkiest stuff and then they are censoring it.

Decensored

[Only available for movies] Some programmers are working on algorithms to decensore censored movies. And it works better than expected.

Vertical

[Only available for movies] Video is vertical and thus maybe better suited on a mobile phone.

Mirrored

[Only available for movies] Video is mirrored.

Secret

[Only available for movies and bookmarks] See the FAQ: What are secrets?

Public Description

You can provide a public description here which would be included in an export file. For movie entities this should include the text of the cover (or website) if it's available.

Private Description

Here you can leave a private comment. A private description will not be included in an export file.

Rating

Your personal rating for this entity. I personally use a scale from 1 to 10. 1 would equals "why the fuck do I have this, absolutely not my type, rather disgusting" and a 10 would be "top-notch". In case for exceptionally good material I introduced also a 11 (=exceptionally top-notch) and 12 (=perfect). But that's up to you.

Immersion

While the rating is an overall rating for the scene, the value for immersion rates the scene by how good you can immerse into it. I have seen scenes which were really great to watch (high rating) but I couldn't really dive into it. And vice versa.

Partner compatibility

[Only available for scenes] If you are watching from time to time with your partner together you can rate each scene regarding the compatibility with your partner.

Primary Person

[Only available for bookmarks] To whom does this bookmark apply to? Useful for scenes with more then one female. E.g. in a threesome scene where one woman does anal (person a) and one (person b) does not. If you would now search for scenes of person b where she does anal Scenerixx' search couldn't determine the result exactly if the primary person is not provided.

Studio

[Only available for movies] The studio (or website) who released the movie.

Type

Each entity can be tagged with a type to specify what kind this movie / scene / bookmark is to find later exactly what you are looking for.
While you can provide up to three types for movies and scenes (which are quite generic), bookmarks can have only one type (which is quite specific). The movie-window allows you to order movies by type (considering only types that have been applied on a movie entity).

No.

[Only available for scenes and bookmarks] Specifies the position within the movie and is used to display the entity in the correct order. Scenes can be re-arranged in the "movie"-window via drag&drop.

Start-/Endtime

The start- and endtime of a movie / scene / bookmark. Scenerixx tries to guess the correct medium file when you are entering a time (to be more specific: as soon as you leave the minute-inputfield).
For example: you enter the beginning of the first scene which starts at 00:01:23, Scenerixx will automatically choose the first associated medium file. If you are now entering the endtime and the endtime is behind the starttime, Scenerixx will select the the same medium file. If it is *before* the starttime Scenerixx assumes that it ends in the next file and selects therefore the following file. That will only work, if you start with the very first scene because Scenerixx depends on the data of the previous scene.
If you select directly an end-medium the endtime will be filled with the length of the file (if this value is known either because mediainfo determined the length or you provided it manually).
This works quite well but you should still check if Scenerixx determined the correct value.
There are some cases where Scenerixx cannot determine a value (especially with bookmarks or if a scene starts at 00:00:00 in a file which is not the first) and will do therefore nothing. In those cases you need to select the correct file on your own.

You can navigate through the textfields with the cursor keys (left/right to skip to the previous/next one, up/down to change the value). The value of the textfield that has the focus can also be changed with the mousewheel.

Title/Chapter

This applies only to DVDs where you have titles and chapters and not medium files.

Date of shoot

[Only available for movies and scenes] The date of shoot / production. If you provide the date when a movie node is selected Scenerixx will ask you if this date should also be applied to all the scenes.
Each scene can have a different date in a movie (think about compilations). The date is used to calculate the age of the persons in the scene.

Spoken language

[Only available for movies] The main language which is spoken in this movie. You can specify the spoken language for each person in the person details.

Available values:

Audio synchronized

There was a time where movies were synchronized. Those days are long gone (fortunately), but in case you still have some historic movies in your collection, this flag is for you.

Audio desync

[Only available for movies] See the FAQ.

Sound / Video Quality

[Only available for movies and scenes] Describes the quality of the video and sound.
If you apply a quality value on the movie entity it will be saved for all associated scenes if either none of the scenes has a value yet or they all have the same value. If the value differs between the scenes, you cannot choose a value for the movie-entity. Possible values are:

Location

[Only available for scenes] You can choose up to three locations where the scene takes place.

Condoms used

[Only available for scenes] If condoms are used in this scene or not.

Save

Saves all the changes. But you know that, or? You can also use the shortcut CTRL+S to save the details. If you are saving the details of a scene, the next scene will be selected after saving.

I came

[Only available for scenes and bookmarks] Facebook has a Like-button, Scenerixx has an "I came"-button.

Scene Overview

[Only available for movies and scenes] Shows the available scenes within this movie. You can select a scene here.

Current Scene

[Only available for scenes] Shows the associated persons to this scene. As soon as you select a person Scenerixx will show the person details tab where you specify more detailed information about this person within the scene.

Gant chart

[Only available for scenes] If you added bookmarks to your scene those will be visualized in a Gantt chart.
Like this you can see right away how much time a certain bookmark type has within the scene and / or on whom the focus is if there is more than one person involved.

Person Details

Credited as

If the person was credited with a different name as usually, provide it here.

Face Censored

If the persons face is pixelated.

Cuck

If the person appears as cuckold / cuckquean. Persons who have this flag set will appear in a different color in the trees.

Non sex

If the person appears in a scene only in a non-sex role. Persons who have this flag set will appear in a different color in the trees.

Mentioned age

If the birth year of the person is known and the year of production of the scene Scenerixx automatically calculates the age of the performer and display it in the scene node.
In case those information are missing but you are able to retrieve the age in a different way (e.g. movie title or interview before the scene) you can provide the mentioned age here. And since I know that some performers are 27 for several years in a row the age in the scene node is prefixed with a "m: ".

Guessed age

If the birth year of the person is known and the year of production of the scene Scenerixx automatically calculates the age of the performer and display it in the scene node.
In case those information are missing but you want to take an educated guess you can provide here an age range that will also be displayed in the scene node.

Body Type

[Only available for females] This property is pre-selected from the person data (if available) and can be changed for this specific scene. This can be useful in case the actress changed (e.g. gaining so much weight that she's not considered a babe anymore rather a BBW, like Carmella Bing after her pregnancy for example).

Fake Tits

[Only available for females] This property is pre-selected from the person data (if available) and can be changed for this specific scene. This can be useful in case the actress got a boob job in the meanwhile (or the scene is from the early days of her career where she started with natural tits).

Obviousness

[Only available for females] This property is pre-selected from the person data (if available) and can be changed for this specific scene.

Tits Size

[Only available for females] This property is pre-selected from the person data (if available) and can be changed for this specific scene. This can be useful in case the actress got a boob job or her appearance changed due to weight loss / gain.

Ass Size

[Only available for females] This property is pre-selected from the person data (if available) and can be changed for this specific scene. This can be useful in case the actress lost/gained weight and appears different than usually.

Pubic Hair

The length of the pubic hair. Possible values are:

Hair Length

The length of the (head) hair. Possible values are:

If you need some visualization help, look for example here.

Hair Color

The hair color. In case the default value is "colored" you should overwrite the hair color on each scene. If it's artificial, you can provide further information in the "public description".

Hair Style

The style of the hair. Possible values are:

Hair Type

The type of the hair. Possible values are:

Makeup

The amount of makeup the person is wearing. Possible values are:

Nails

Were the nails made?. Possible values are:

Dirty Talk

The amount of dirty talk. Possible values are:

Dirty Talk Intensity

Only available when there is some dirty talk in this scene. Possible values are:

Dominating

Is the person dominating its partner or is it dominated by it? Possible values are:

Disgusted

How much is the person disgusted? Possible values are:

Enjoyment

How much does the person enjoys? Possible values are:

Appearance

What kind of appearance does the person have? Possible values are:

Language

The language the person is speaking. Useful if it differs from the general language that is spoken in the movie.

Moaning

The amount of moaning. Possible values are:

Screaming

The amount of screaming. Possible values are:

Tits Bouncing

[Only available for females] How much do the tits bounce? Possible values are:

Clothes

You can select here what kind of clothes the person is wearing. You can select several values just by clicking on a value. No need to hold the CTRL-key.
E.g. A person can wear lingerie under a business dress and gets during the scene completely rid of the clothes. In this case all three values (Lingerie, Business dress, Naked (fully) would apply).
NOTE: If you are missing a value here, drop me a line.

Jewelry

You can select here what kind of jewelry the person is wearing. You can select several values just by clicking on a value. No need to hold the CTRL-key.
NOTE: If you are missing a value here, drop me a line.

Cumshot Details

This tab is only available if a bookmark of the any type of cumshot is selected.

Rating

Your personal rating.

Quantity

How much jizz? Available values:

Position (receiver)

In which position is the cumshot received? Available values which should be self-explanaining:

Disgusted (receiver)

How disgusted does the receiver looks like? Available values:

Enjoyment (receiver)

How much does the receiver enjoys the load? Available values:

Swallow

If the receiver swallows the cum or not.

Cleanup after

If receiver takes the dick after the cumshot back into her mouth to clean it up.

Screencaps

If a screencap exists for the selected movie, it will be shown here. Scenerixx searches for screencaps in the directory which is defined in the options. If no screencap exists yet, you can create it by clicking the button "Generate Screencap". With a double click on one of the pictures you can open VLC at this position.
If the option "Hide screencaps in locked mode" is activated you will see an empty tab if you are in locked mode.

NOTE: For generating a screencap FFmpeg must be installed. Also consider that the generation of a screencap with FFmpeg will occupy at least one CPU core for 100% for several minutes for each file (sometimes much more).


Medium Files

You can search the index in this window.

The result tree

Shows all files in the index. If a selected file is associated to a movie the movie will be also selected in the movie-window.

With a double-click you can open a medium file (looped).

Used icons
Context menu

Open File - Opens the selected file. If the movie is split over several files and have a common pattern in its filename use the "Start VLC"-button

Open File (looped) - Opens the selected file in a loop.

Add To Default Playlist [Playlistname] - Adds the file to the current default playlist. If no default playlist exists Scenerixx will create one

Add To Playlist - Adds the file to the playlist that you select.

Open Directory - Opens the directory in the system file browser

Make mediumfile secret - Set the secret flag on this file so that it will be find only in an unlocked session

Rename file on disc - Renames the file on disc and updates the index

Rename file extension on disc - Renames the file extension on disc and updates the index

Hash file / Re-hash file - (Re-)Hashes a file

Update media information - Update the media information with MediaInfo of this file

Delete from database - Deletes the file from the index

Delete from disc - Deletes the file from the index and from the disc. This cannot be undone!

Search

Searches the index for the provided searchterms. Not only filenames but also the corresponding paths will be searched. All searchterms must be found within path and/or name.

If a search term should NOT be included prefix it with two dashes, e.g: "Julia Ann --lesbian" will find all files with "Julia Ann" included in the file names but none that will include "lesbian".

If you want to search for an exact phrase use quotes. If you search for "Avi Love" without quotes each file with the extension *.avi and the term "love" in the file name would be found. With quotes only files with the exact phrase will be found.

With CTRL+Space you can trigger a auto completer to show you previous search terms (needs at least two characters).

Fields

Changes to any of the fields needs to be confirmed by clicking the "Save" button.

Width

The width of the movie

Height

The height of the movie

Duration

The duration of the movie

Part

If the movie is split over several files this one indicates which part of the movie this file represents. Scenerixx will usually open a movie with all parts ordered by this property.

Rating

Your personal rating.

Exportlevel

The export level. Do NOT mess around with this if you want import/export to work properly.

Audio Desync

You can provide a value for Audio Desync here. Usually you won't need this.

Type

Defines which kind of files should be shown in the result tree. Only pictures, movies or all files

Hiding

Do not hide any files - Don't hide anything

Hide files that are associated to a movie - Applies only to movie files

Hide files where duration is already known (or file type has no duration) - helps you to find the movie files where MediaInfo was not able to determine the duration

Hide files where hash is already calculated

Ordering

Ordering by name - default

Ordering by runtime - only useful for movies

Ordering by resolution - only useful for movies

Ordering by last modification - comes in handy when you search for one of the last added medium files

Show Duplicates

Show duplicates by name - useful if you are searching for files that might duplicates because some files might be broken, aborted downloads or a movie in a different resolution

Show duplicates by hash - useful if you are searching for duplicates of a file in other directories or same files with other filename

Other

Show Counter

Shows behind each node how often the file was started. NOTE: This option might slow things down

Show Directory

Shows also the directory of the file. NOTE: The ordering is still done by the filename.

Start VLC

If the selected file is part of a movie which is split over several files and contains the string "CD1" in its filename, Scenerixx tries to find the other parts and open them too. The other parts must have the same name (except the number). E.g. If a movie is split into two files "movie - cd1.mpg" and "movie - cd2.mpg", Scenerixx opens them both.
If you select more then one file and all files are movies, all movies are opened (queued) within VLC.
If the file type is not known or more then one file is selected and not all selected files are movies, only the first selected file will be opened with the associated standard application.

Creating movies

You can create movies in three different ways from your medium files.

Create new movie

Creates a movie from one or more mediumfiles. You'll be asked (optionally) to provide the amount of scenes which should be created. If you click "cancel" in this dialog no scenes will be create but the movie itself will be created.
The mediumfiles will be added in the same order to the new movie you selected them.
The movie name will *not* be set and needs to be provided manually.

Create single scenes from selected nodes

Creates for every selected node a movie with one scene.
The filename will be used as the movie name. Scenerixx will ask you if you want to use a prefix for the movie name. This can be helpful if you selected only scenes from e.g. Lisa Ann and every movie title should start with "[Lisa Ann]".
If you don't want to provide a prefix just click "ok". If you click "cancel" no single scene movie will be created.

Create movies from selected nodes

Creates for every selected node a movie without any scenes. Scenes needs to be added later manually.
The filename will be used as the movie name.


Search

This window becomes really useful after you provided a lot of data to a lot of movies.
You can either search for scenes or bookmarks. If you are searching for bookmarks do NOT select any 'No'-option. Only bookmarks which matches any given 'Yes'-option will be included in the search result.

NOTE: Since Scenerixx 2.0.0 you can also search for persons. So you could for example specify: search all blondes between 30 and 40 that performs in lesbian scenes.

If you are searching for scenes you can let Scenerixx also consider tags (words prefixed by a hash (#)) in filenames. Imagine you have two movies with the following filenames in your collection (without any manually added types):

If you now search for scenes of the type MILF and have the checkbox "tags" selected the movie "Older but better - #MILF.avi" is found by Scenerixx. "Another MILF movie #older.avi" won't be found because it does not contain any (matching) tag. This logic does not apply when searching for bookmarks!

Be aware that the search for tags within filenames has some drawbacks:

Once you have a search result you can either open selected results (randomized) or create a playlist from the result. To open several results at once you can also use CRTL+Enter.

You can remove single result items with CTRL+DEL from the list to get a better overview if the search returns too much results.

Managing searches (using a default search, save searches)

The first tab in the lower part of the window is called "Saved Searches" and is the only tab which is not directly involved in a search.
Here you can save the currently used search settings (Save current search as new search), load them (Load) and also delete them (Delete). Like this, recurring search pattern don't need to be entered every time from scratch.
A previously loaded search can be modified and updated (Update current search).

Default Search, Reset & Clear

You can make one of the saved searches to the default search (Use as default search). It will be prefixed with [*]. This search will be loaded the first time you open the search window or when you reset a search.
The clear button will reset every option in your current search to it's default value and will not consider any existing default search.
If no default search exists the reset and clear button have the same functionality.

Search options

In the lower part of the window you define your search. The more search options you provide the more exact (leading to fewer search results) your result will be.

Number of females

You can provide a minimum and a maximum number of females who should appear in a scene. If you enter e.g. 3 and 5 only scenes with 3, 4 or 5 female persons in it will be found. Depending on those values some search options might change.

Number of males

You can provide a minimum and a maximum number of females who should appear in a scene. If you enter e.g. 1 and 1 only scenes with exact one male person in it will be found. Depending on those values some search options might change (E.g. if a maximum of one male person is provided, you cannot search for DP).

Age

You can provide an age range what the youngest and / or oldest age the performer should have. That implies that the date of shoot and the year of birth of the performer must be known. If more then one performer (of a specified gender) appears in a scene all performers must meet the range (except performers without a known birth year).
If you specify a minimum number of performers greater than one a second age range can be specified. If you are looking for mother/daughter scenes you would enter "2" for Number of females and in one age range something like 18 and 25 and in the other range something like 36 and 50.
At the moment you can specify only two ranges for each gender.

Min. rating

Find only scenes which has the provided rating or higher.

Length

You can provide a time range (in minutes) how long a scene / bookmark should be.

Min. Width/Height

Find only scenes which has the provided minimum width and/or height. That requires that those information are available (either you used mediainfo or provided those values manually).

[Bookmarktype] yes/no/whatever

You specify for each listed bookmarktype if this should be present (option "yes") or absent (option "no") in a scene. If you don't care leave it on "whatever".
If you are searching for bookmarks include your desired searchterms via the "yes"-option. Do NOT click any "no"-option.

Person tree

You can narrow down the available persons in the tree by providing some search terms in the search input field. A person have to match only one of the search terms. For example: if you type in "ash gianna james" the tree might be narrowed down to: "James Deen", "Gianna Michaels", "Ashlynn Brooke" and "Sasha Grey".

You can narrow down your search by choosing one or more persons which must be included in a scene. You can select several persons in the tree while holding CTRL on your keyboard while clicking on a person.

The result tree

After you provided your search options and hit the "Search" button the tree will be updated with the search result. Each node is a matching scene or bookmark. The contextmenu is the same as here. You can expand each node to see existing bookmarks to the selected scene.


Playlist

A playlist can contain a mixture of movies, scenes and/or bookmarks (as long as they are not on a DVD).
Playlists can be ordered from new to old or by name. The default and history playlist will be always on top. Playable items (movies, scenes,, bookmarks) can be dragged to a playlist to be added.
You can also move playlist entries from one playlist to another via drag & drop.

Temporary Playlist

Each playable item (movie, scene, bookmark, person, studio, medium file) can be added via F6 to a temporary playlist.
A temporary playlist will be discarded on shutdown.

Contextmenu for the root node
Contextmenu for the playlist node
Contextmenu for the playlist entry node
Deleting several playlists at once

You can select several playlists while holding CTRL and delete all of them at once clicking on the button "Delete selected playlist(s)" or by pressing DEL.

Merging / Copying a playlist into another

You can merge a playlist into another one by just dragging it to another playlist node. The source playlist will be deleted after that.
If you want to preserve the source playlist and just copy the entries into a second playlist, hold the CTRL key pressed while dragging the playlist to another.
You can also copy/move single playlist entries to another playlist.


Person Details

This window allows you to create new persons and to view details to an existing one (e.g. if you are selecting a person in the " Persons"-window). Some information are provided for further information about this person (like all the URLs) and some are used by Scenerixx for sorting/searching.
If you create a new person which not exists please consider exporting and sending it to me so that others can profit from your work. In case you are doing that (thanks in advance) please provide as much information as you can find (please refrain sending in partial exports when you are too lazy to do two minutes of research. If the data cannot be found, partial exports are ok).

NOTE: I know that especially the type and sizes can be debatable. That's why I include for those values some examples later on in the description. Sometimes you have corner cases where you could justify two values, for example tits that are too big to be categorized into "normal" but too small for the "big" category. That's why at one point I introduced a "differentiator" why you can indicate if it's (+), less (-) or equals (=).
Remember that those values that are saved directly on a person are just default values which can be overwritten for each scene. The human body is subject to change during the time. And especially performers who return after a pregnancy to the industry might look totally differently.
For those cases you can have different data (ass and tits size, body type and appearances) for several time spans. That's especially helpful if a performer was undergoing some surgery.

Even though the fields should be more or less self-explanatory, let's have a quick look at them:

Profile picture

Shows the provided profile picture. With a click on it you can enlarge the picture. See the FAQ how to provide a profile picture.

Fields

Favorite

Mark a person as favorite to have a quick overview over your current favorites in the person overview window.

Male/Female/TS

Depending on the selected gender the fields vary a bit. Females have more fields. TS have most.

Name

The name of the pornstar. If the person is credited differently in different movies, use the name which is used most often. If a person is usually credited only with a forename but is also known with a lastname, use the combination of both. E.g. "Naomi Russell" is usually credited only as "Naomi" but I used "Naomi Russell" here because it's clearer in case another person is credited with the same forename only.
Other aliases can be provided on each scene. If the person appears in some scenes under a different name those aliases are shown under "Known Aliases".

Real name

In case the real name of the person is known you can provide it here. Please do not include any real names which are only known because of leaks. If someone wants to keep it private and don't want to share it with the public this should be respected!

Official Homepage

The address of the official site, if one exists. Don't include here any rip-offs (e.g. www.club[name].com) who look all the same and are *not* official.

Twitter

If the person has a Twitter account, provide it here. Don't include any fake profiles, any spammer profiles or accounts that were dead from the beginning (only a handful of total tweets and no activity since years). Accounts that are dead but were used on a regular basis I usually include.

Instagram

Same as Twitter, but for Instagram.

IAFD

The IAFD-page for this person. IAFD provides additional information (like measurement, tattoos, birthplace, etc.) and usually a quite comprehensive list of movies/scenes ther person appeared in.

Wikipedia

The wikipedia page if an entry for this person exists. If available provide the english version here. If no english article is available I usually provide one of the other languages (like spanish, french, german). Since Wikipedia links to articles in other languages (if they exist) this is just a small inconvenience if the provided language is not your mother tongue.

Ethnicity

The ethnicity of the person. If it's not obvious what kind of ethnicity the person is, choose "Multi". Available values:

Hair color

The hair color the person usually appears with. This property can be overwritten for each scene individually but would be used as a default value if no scene-specific value is provided. Available values:

Body Type

The type of body the person has. This property can be overwritten for each scene individually but would be used as a default value if no scene-specific value is provided. Only available for females. Available values:

Fake Tits

If the tits are fake or not. This property can be overwritten for each scene individually but would be used as a default value if no scene-specific value is provided. Only available for females.

Obviousness

If the tits are fake you can specify here how obvious it is. This property can be overwritten for each scene individually but would be used as a default value if no scene-specific value is provided. Only available for females.

Tits size

The size of the tits. This property can be overwritten for each scene individually but would be used as a default value if no scene-specific value is provided. Only available for females. Available values:

Ass size

The size of the ass. This property can be overwritten for each scene individually but would be used as a default value if no scene-specific value is provided. Only available for females. Available values:

Other URLs

Here you can provide other URLs like Facebook, MySpace, a second Twitter account, whatever.

Birthdate

The birthdate. Scenerixx calculates from this the age of the person if the date of shoot is also known. At least the birthyear needs to be known for that.

Rating

You can provide a rating (which can be used for sorting and the search later on). I personally use a scale from 1 to 10. 1 would equals "why the fuck do I have anything of this person, absolutely not my type, rather disgusting" and a 10 would be "top-notch". In case for uber uber uber cuties and marriage material I introduced also a 11 (=exceptionally top-notch) and 12 (=perfect). But that's up to you.

Known Aliases

If the person appears under a different name in some scenes than the one provided under "Name" those aliases are shown here.

Secret

If this checkbox is selected the person will be only shown when you unlocked the session in the menu via "Scenerixx / Unlock Secret Items". This can be useful if you don't want anybody else to see this person if they are browsing your collection. (E.g. the mom of a friend of yours, ex-girlfriends, etc.)

Reminds me of (checkbox)

Select this checkbox if you want to create a person entity for someone that you are reminded of.
E.g. for your neighbour, teacher, crush, co-worker, whatever.
Those persons are displayed in another color when you add them to a scene.
If they should not always be displayed check also the secret checkbox.
In the " Persons"-window you have the possibility to show only persons who reminds you of someone else.

Reminds me of (combobox)

You can define up to three other persons that this person reminds you of.
Those persons are also in a scene association. But they are not shown in the persons panel if you select "Reminds me of" (for that you need to select the checkbox).

Private Comment

Comments you have on this person. This field is always visible no matter if the session is locked or unlocked. It's only called private to make clear that this data will not be exported if you are making an export of this person.

Buttons

e / i

Before the URLs are buttons which will open the URL in a browser.

New

Clears the form and creates a new person.

Save

Saves the current person. To save a person you need to provide at least: name, gender and ethnicity. You can also use CTRL+S *but* the details window must not be visible because it shares the same shortcut. If it is visible the details will be saved and the person not.

Reset

Resets the person to the last saved state.

I came (n)

n represents the number of how often you came (or better: how often you clicked the button). There is also on each scene/bookmark such a button. You can use the button on the person if the happy event was not bound to a scene rather to your imagination, a picture or whatever that made you think about this special person.

Download images

If you specified under 'Tools / Options / Directories' a 'Random profile picture directory' you can let Scenerixx try to download images of this person.

Scenerixx will use https://search.brave.com/ to find some images of the performer and download them in background. This whole process will take ~30 seconds. But you can continue using Scenerixx in the meanwhile.

NOTE:

Drop Downs

Load any existing person

A shortcut to load any other existing person

performed with

A list of all persons the currently loaded person has performed with.

Similar persons

Depending on characteristics like body type, size of tits, ass, hair color, ethnicity and so on Scenerixx calculates a scoring value how similar the currently loaded person is to other persons. The lower the value the more similar the persons are.

Export

Exports this person to a scenerixx-file.

Import from file

Opens a file dialog where you can choose a scenerixx-file containing a person to import.


Studio Details

This window allows you to create new studios and to view details to an existing one (e.g. if you are selecting a studio in the " Studio Overview"-window). The term studio is here broadly defined and includes beside studios websites if they provide original content.

Fields

Name

The name of the studio / website.

Wikipedia

The URL of the wikipedia entry if one exists.

Official Homepage

The official homepage.

Official Homepage 2

Most studios have more than one official homepage (e.g. for press releases and endconsumers). You can provide a second URL here.

Twitter

The official Twitter account.

Twitter 2

Like the homepage studios tend to have several Twitter accounts.

Other URLs

Any other URLs, if the other fields are not sufficient.

Founded

Founding year. Nothing that is really used anywhere till now.

Buttons

e / i

Behind the URLs are buttons which will open the URL in an external browser

New

Clears the form and creates a new studio.

Save

Saves the current studio.

Reset

Resets the studio to the last saved state.

Export

Exports this studio to a scenerixx-file.

Import from file

Opens a file dialog where you can choose a scenerixx-file containing a studio to import.


Indexing, Hashing, Purging

Scenerixx needs to know where your files are. So, first you need to index those files, then hash them and optionally update the media information afterwards.

Choose directory for indexing

Choose the directory which should be indexed. If sub-directories should be included select the checkbox "Include sub-directories". Scenerixx will then read in all files in the directory and write the filenames into its database.
You can repeat this process as often as you like and add all directories you want to manage with Scenerixx. It doesn't matter if the files are directly on your harddrive or on an external drive. Scenerixx won't include duplicate entries so you don't have to worry about that.
This whole process shouldn't take that long (less than two minutes, depending on the size of the directory and the speed of your drive).
NOTE: try to avoid adding files. It's no harm if documents, binaries, etc. are included in the index but might slow things down if the database grews unnecessarily big. So don't include the root-directory of your harddisk.

Start hashing

After you indexed your files you need to hash them. A hash is kind of a fingerprint to identify a file and looks something like this be61adf69a400f30bc0c182611edc0ba209d388f. (For the tech-savvy folk among us, Scenerixx uses SHA1). The huge advantage of hashing the files (and the reason why Scenerixx does that) is the fact that you don't have to rely on a filename to identify a file. With this hash we can identify a movie and therefore provide further information about it (in form of scenerixx-files) if the hash is already known to us.
Hashing is absolutely essential to Scenerixx. You cannot associate an unhashed file with a movie.
The hashing process itself takes quite some time since every bit and byte of every file is needed to be read. Depending on the size of your index (and the speed of your disc) this might take several hours.
You can always abort the hashing process and continue it later on. Each file needs to be hashed only once so it's a one time thing.

After the hashing process is finished, Scenerixx starts automatically the import process where Scenerixx checks if for a hashed file a corresponding import file exists. If an import file is found, Scenerixx will import this file into the database so that you don't have to enter all the information again.

Purge

This is to help cleaning up the database.

At first Scenerixx checks if some detached database entries exists and removes those. And then:

If you rename or delete files on your disc the data in the database will be out of sync. Clicking 'Purge' will clean up your database. In case you renamed files, you should first index your directory again and purge directly afterwards. Do NOT hash your files in between. Scenerixx will try to find renamed files and re-assign them so that you are not losing any information (counters, associations to movies, etc.).
You should make sure that all devices are connected (in case you indexed anything on external devices).

Add single file to index

Adds a single file to the index. If you acquired a new movie or you want to index only a single file and not a whole directory, this is the way to go.

Index DVD

When you want to index a DVD you need to choose the directory with the VOB-files in it. Scenerixx will then try to build hash and check if the DVD is already known.
Since DVD drives are slowly Scenerixx is not building the hash of each file but rather concatenates all filesizes into a string and calculates the hash on this string. If you want to have more information on the technical details, drop me a line.

Update mediainformation

If you have MediaInfo installed (as suggested in the requirements) you can update the media information of the movies. MediaInfo tries to determine the resolution and duration of the movies. This works usually for >95% of the files. But you can also provide those information manually in the " MediumFiles"-window, in case you don't have MediaInfo installed or MediaInfo is not able to determine those values.
This might also take some time (not as long as hashing but longer than indexing) but can also be aborted whenever you want. It's not necessary that files are already hashed.
The determined values can be used for searching and/or ordering later on.

Generate Screencaps

If you have FFmpeg installed (as suggested in the requirements) you can create screencaps for each movie. Consider that the generation of a screencap with FFmpeg will occupy one CPU core for 100% for several minutes for each file (sometimes much more).
The created screencaps can be viewed in the screencap-tab of the details window of a movie.
NOTE: the output of FFmpeg is quite verbose and might contain several warning and error messages which can be ignored. Frankly speaking, I just show the output so the user knows that FFmpeg is still working and he does not have to stare on a blank window for several minutes until he gets a feedback from Scenerixx.

Purge Screencaps

If you delete a scene or movie where a screencap exists this screencap is not deleted right away. You have to purge them manually.
It can also happen that during the generation something went wrong and a zero byte file is created which has the effect that no screencap can be shown but also no screencap gets generated. Those zero byte files will be also deleted.

Find Duplicates

Duplicates are an annoyance. They take a up space and you might enter data several times. While Scenerixx can find exact duplicates (via the hash of a file) it's a bit more tricky if the duplicates have a different resolution and / or a different file size.
To find also those duplicates this function compares the screencaps of all movies with the exact same runtime and if the difference between those screencaps are below a certain threshold (at the moment 10.0) they are considered as duplicates and both movies are saved on a separate playlist.
This whole process is quite lengthy. Depending on your collection size and your CPU this might take several hours (like 12 hours and more). Therefore you can specify with which runtime (in seconds) Scenerixx should start so that you can abort the process in between and continue later on.
You can also define a threshold value to define how sensitive the duplicate finder should react. A value of 10.0 will most likely not generate any false positives. A value 20.0 generates a few false positives but will find duplicates where the screencap differs already quite a bit. Anything above 25.0 will generate a lot of false positives.
If not otherwise specified the duplicate finder will compare only movies with the same runtime. With "difference in seconds" you can change this behavior and allow the comparison of movies where the runtime differs. This might lead to more results but also takes much more time.
After the process finished you can go through the playlist and check if the playlist really contains duplicates and delete them accordingly.
False positives can be marked as 'no duplicate'.

Bulk Renaming

With this functionality you can rename the filepaths in the database en bloc.
This is especially useful if you move your collection (or parts of it, e.g. to another hard disk) and you don't want to re-index and re-hash those files. You could simply replace the string "C:\" to "D:\" in all filepaths. Don't use this function when you are drunken. And a backup is always a good idea. ;-)

Wizard

The wizard combines most functionality of the " Indexing, Hashing, Purging"-window. You choose a directory and the wizard indexes, hashes, gets the runtime information, creates movie entities, add scene entities to those (if a certain runtime is not exceeded), creates the screencaps, analyzes the filename and import based on that person data and assign persons to solo and lesbian scenes if we can determine the persons. And the same is done for studios.
The person name does not need to match exactly rather those three forms are valid to be considered a match: "DarlaCrane", "Darla_Crane" and "Darla Crane".
So: all in all quite useful if it works. Since its not always fault-free a flag is set on each created movie entity. In the details window a hint is shown if the data were generated by the wizard. With the click on a button you can confirm the correctness of the data.
NOTE: files that have been previously deleted will not get imported again.

Abort

Aborts a currently running process (indexing, hashing, importing, updating mediainformation). This might take some time. If Scenerixx is hashing currently a file and you hit abort, Scenerixx will finish hashing the current file and stop after that the further hashing process.

Import Importfiles

Scenerixx comes already along with some import files. But hopefully those will get more and more week after week. Check the twitter account for the newest import files. Those come along in a zip-file that you can upload here. Scenerixx will extract the newest import files and start the import process after that.


99% of the time you will not need the menu.

Exit - Exits Scenerixx

The menu entries Movie List, Details, Persons, Person Details, Medium Files, Playlist, Search, Studios, Studio Details and Indexing, Hashing, Purging opens the corresponding window. You will need this only if you closed a window before.

Lock Secret Items - Locks an unlocked session. That implies: all secret entities are hidden again and the behavior of loading profile pictures change. When a session is unlocked it's written in the titlebar.

Unlock Secret Items - Unlocks a session to show secret entities. In case you provided a password in the options you have to enter this first.

Disable Expensive Icons - The reload of the movie list is quite an expensive operation. The bigger your collection the more painful it gets. To mitigate this problem a bit your can disable the usage of some icons which are quite expensive to calculate: ISO files, DVDs, movies on a playlist.
If those icons are disabled you can speed up the reload by ~20%.

Clear notifications - Clears notifications. Notifications disappear after some time on its own. So this is only useful if a lot of notifications were shown in a short amount of time.

Notes - A small helper. Sometimes you might want to take notes like noting the name of a studio that you don't have and want to create later because you don't have the time right now. Happened to me more often than expected. That's why it is here :)

IDE Log - You won't need this unless you want to gain some inside on what is going on inside Scenerixx. Only useful for troubleshooting and debugging.

Full Screen - I tried to make Scenerixx useable on smaller screens. If you need to gain some more pixels switch to full screen (which omits the title bar).

Options - Shows the options dialog

You won't need any of this. This menu is part of the NetBeans platform on which Scenerixx is based on. The only menu entry worth mentioning is Reset Windows in case you messed the windows up and you want to have the original layout back.

Scenerixx Help - Shows this help

Scenerixx Changelog - Shows the changelog

Check for updates - Checks if a newer version of Scenerixx is available

Tip of the day - Shows some helpful tips about the features of Scenerixx

About - Licence stuff and information about the system which might be useful for troubleshooting


Options Dialog

General

Log Level

Defines which log messages should be shown in the output window. Only useful for troubleshooting.

Font size

Defines the font size in percentage. A value of 100 is the normal size. A value less than 100 makes the font smaller. A value bigger 100 makes it bigger.
Do not use a value too high. A value of 150 e.g. would make the application already unusable. Maybe experiment with this value in steps of fives.
NOTES: A restart is required for changes to take effect. And icons will NOT change in size.

Show last X movies

Defines how many movies should be displayed when in the movie list the option "show last X" is selected. Default value is 10.

Show help on startup

If you don't want to see the help on every startup, uncheck this box.

Show only favorites on startup

The startup of Scenerixx increases with the size of your collection.
To speed up the startup process you can load only favorite movies in the movies tabs after starting. Of course you can show all movies again by selecting the value from the combobox.
In sum it makes no difference if you are always select to show all movies directly after startup. But if you want to e.g. add new persons in a session where you are not using the movies tab it is really helpful.

Hide profile pictures in locked mode

Defines if profile pictures should be always hidden in locked mode or shown depending on the rules defined here .

Show random profile pictures in unlocked mode

You can specify a directory under "Directories / Random profile pictury directors" where you store more pictures which should be displayed as profile picture. Subdirectories will be included. For the details see here .

Hide covers / screencaps in locked mode

Defines if covers should be always hidden in locked mode. I mainly implemented this so that my toddlers could walk into my room during development without seeing explicit content.

Hide screencaps in locked mode

Defines if screencaps should be always hidden in locked mode. I mainly implemented this so that my toddlers could walk into my room during development without seeing explicit content.

Use Smart Start

When Smart Start is activated Scenerixx will open a movie at the Intro-bookmark or, if this is not available, at the first scene. Skip all the legal disclaimers and logos and get right to the action.

Skip Interviews

When this flag is set and the first boomark in a movie is an interterview the interview will be skipped when the movie is started.

Skip Story

When this flag is set and the first boomark in a movie is of the bookmark type "Story" then the interview will be skipped when the movie is started.

Change Look & Feel

You can change the look and feel here. Just select one of the available look and feels from the drop down box and confirm your selection with the "Change Look & Feel" button. Some look and feels can be customized by a theme.
Scenerixx will save your selection and use your selection starting Scenerixx the next time.
The windows look and feel is only available on the Windows plattform.

Hide 'Tip of the Day' on startup

Scenerixx shows after startup a more or less helpful message about the features of this program on the screen.

If you don't want this dialog to be shown on every startup, deactivate it here. You can call this dialog under "Help / Tip of the day"

Check for updates on startup

You can check manually if a new version of Scenerixx is available under "Help / Check for updates" or you can check this option and let Scenerixx search for a new version with every start.

Calculate internal statistic on startup

If this option is activated Scenerixx gathers some numbers needed for the statistic on startup.

Always apply "date of shoot" to scenes when saving a movie

Usually a dialog asks if the "date of shoot" should also applied to scenes if a movie is saved. With this option the dialog gets skipped and the date will always get applied to the scenes. Unless some scenes have already a value. In this case you will be asked if those values should be overwritten.

Always apply "movie types" to scenes when saving a movie

Usually a dialog asks if the "movie types" should also applied to scenes if a movie is saved. With this option the dialog gets skipped and the types will always get applied to the scenes.

Search on keypress

Before Scenerixx 3.0 search results updated automatically on each keypress. That could have cost quite some delays if the search result was quite big.
Since Scenerixx 3.0 you need to confirm your search with the enter key. If you rather prefer the old behaviour this option is for you.

Create history playlist entry when a playable is started via a double click on the screencap

With Scenerixx 4.1.0 a feature was introduced to open a movie via a double-click on the screencap. Up till version 4.6.0 no playlist entry for the history playlist was created when you opened a movie like this.
You can change this now by selecting this option.

Note: why is this an option and not just an ordinary bugfix? Because I use the double-click feature quite often only to open a movie while I'm editing data (e.g. getting the runtime of a scene, etc.) and not because I want to watch it right now. Therefore those "starts" of movie is not something I want to have on the history playlist.

Random playlist entries

When you open in the movie window the movie list randomized you have here the possibility to define how many scenes Scenerixx should consider.
The default value is 100. So it does not matter if you have 1.000 or 50.000 in your list only 100 scenes will be opened in a random way.
For some users this was not enough that's why you can configure the value on your own.
Why not taking the whole list and shuffle it? Performance reasons. I opened a list with 50k entries and it took over ten minutes before VLC started. If you still don't want to restrict it set the value to 0.

Tooltip [reshow] delay

Some nodes/components provide a tooltip. You can specify how long you need to hover above such a component to let the tooltip show.
If you specify 1500 ms the tooltip will be shown after 1.5 seconds. If you move to another component with a tooltip and the time between leaving the first component and entering the component is less than the reshow delay the other tooltip will be shown immediately. Once the reshow delay has passed you need to wait again what you have specified as the delay value.

Password for secured items

You can provide a password here which has to be used to unlock a session.
NOTE: While the password itself is stored as a hash (using the bcrypt-algorithm) secured items are NOT encrypted. Thus: if someone has access to your database they can read those items.

Password-protect start

You can provide a password here which has to be used to start Scenerixx or ScenerixxHub.
NOTE: While the password itself is stored as a hash (using the bcrypt-algorithm) the database itself is NOT encrypted. Thus: if someone has access to your database they can read it.

Choose color for highlighting search results

The default color to highlight search terms in the search result is some kind of orange (#FFC40C). If you prefer another color you can choose it here.

Show XXX functionality

The interface is quite overloaded and some features will be probably not be used by everybody. Here you can disable some features. After a change a restart is required else the UI might behave strange or inconsistent.

While DVD, Export and Import are clearly defined features, "rarely used functionality" hides a little bit of everything like:

Directories

Export base directory

Defines the directory in which exports should be saved.

Profile picture directory

Defines the directory in which Scenerixx should look for profile pictures.

Random profile picture directory

Defines the directory in which Scenerixx should look randomly for profile pictures.

Screencap directory

Defines the directory in which Scenerixx should look for screencaps.

Playlists directory

The directory where exported playlists should be saved. Default value is ${user.home}/scenerixx/playlists

Program directories

The binary directories for the programs VLC, FFMpeg and MediaInfo Defines can be specified here in case the programs are not on the path.

Download directory

The directory where Scenerixx should save any downloads the user requests (see also tube movie).The default location is "${user}/scenerixxdownloads"

Browser binary

Usually the system default browser is used when a link is opened. If you are using for you adult browsing another browser you can add here the complete path to the executable.

Screencaps

Screencap: single picture dimension

Defines the dimension of a single picture. Default value is 320x240. The values should not be lower then 20. Don't set it too high since the screencap will be scaled down anyway. Maximum value is 2000.

Screencap: Pictures per column

Defines how many pictures per column should be created. Default value is 5. Minimum is 2. Maximum is 20.

Screencap: Pictures per row

Defines how many pictures per row should be created. Default value is 6. Minimum is 2. Maximum is 20.

Generate screencap for scenes

As default Scenerixx does not create a screencap for each scene. Depending on the size of your collection the needed hard disc space can easily extend several dozen gigabytes.
Scenerixx can only generate screencaps for scenes where a start and an end time is set.

Scenerixx Hub

Port

Which port the server should use Default is 8090.

Start at startup

Should the server be started during startup of Scenerixx.

Wizard

The Scenerixx Wizard tries to make your life a bit easier. You specify a directory that you want to include in your collection and the wizard will index the files, hash them, determine the runtime, create the screencaps and creates the movie entity and maybe also a scene entity (if the runtime is not too long). Furthermore it checks if it's a solo or lesbian scene and tries to associate the person (if known) to the movie. Persons are also added to your collection in case we recognize a person where we have the available data but it's not yet included in database. It also detects duplicates.

A scene is considered up to x minutes

Specifies the duration of a file up until it's considered a single scene.
The default value is 65. If a movie is 65 or less minutes long it's considered a single scene and therefore a scene entity is added to the movie. If it's longer we assume it has more scenes and therefore no scene at all is created.

Prefix movie title with directory name

If your project structure is more or less ordered this can be really helpful. If you ordered your collection up till now for example like this:

    movies
    |-> Aurora Snow
    |    |-> First Movie 
    |    |-> Second Movie 
    |-> Jessa Rhoades
    |-> Bobbi Starr

So the created movie title wouldn't be "First Movie" rather "Aurora Snow - First Movie"

Apply tags

If a filename contains tags like "First Movie #Story #Office #Outdoor" and Scenerixx recognizes the tag it gets set on the movie entity if this checkbox is set.
Per movie entity only six tags can be saved. If more tags are included in the file name you are out of luck.

Play sound after wizard finished

If checked a short sound will be played after the Wizard finished.

Max. number of characters that a filename might diff from the directory to consider it part of a multi file movie

This option is only used if the wizard should try to detect multi file movies.
If a directory is called "The best of Lisa Ann" and the files are:

  1. The best of Lisa Ann - scene 1.avi
  2. The best of Lisa Ann - scene 2.avi
  3. The best of Lisa Ann - scene 3.avi

then there are 14 characters difference between directory and file name. As default 40 characters difference are allowed.
Be aware: If the file names would be called "scene 1.avi", etc. Scenerixx would not recognize it as a multi file movie because directory and file name do not match.

Max. number of files in a directory to take it into consideration for a multi file movie

This option is only used if the wizard should try to detect multi file movies.
As a default value 10 is used. If there are 10 or less files in a directory Scenerixx tries to determine if it's a multi file movie.
If the directory name is present in the file names and the character of difference is not too big, it's considered as a multi file movie and only one movie entity is created and all found files are associated to this movie.

GIF

You can create GIFs from bookmarks.

Where should the GIFs be stored?

In which directory should the GIFs be stored.

How many frames per seconds should the GIF have.

How many frames should they have? The higher the number the more "smooth" the animation is (but the file size will also be bigger).

The width of the GIF

The width the GIF should have.

Backups

Scenerixx creates a backup from your database if you want during shutdown.
If you are using the default embedded database the directory with the database is copied. You can easily copy the folder back in case you have to.
If you are using a MySql or MariaDB a dump is created. And if you are using one of those databases I assume how you can import the dump again ;-)

Where should backups be stored?

As default backups are stored in {user.directory}/scenerixx/backup
You can specify a directory on your own. But keep in mind that nothing else should be stored in there because old directories will get deleted over time. A check if this is really a backup directory is NOT made!

How many backups should be kept?

How many backups should be kept? Default value is 10. If the 11th backup is created one will get deleted.


Scenerixx Hub

Scenerixx comes with a build-in server that let's you stream your collection in your network: Scenerixx Hub. You just need the menu items "Scenerixx Hub / Start Scenerixx Hub" and "Scenerixx Hub / Stop Scenerixx Hub".
After starting the server it will be available under http://localhost:8090

The port can be changed in the options.

If you want to unlock secret items, unfold the menu (the burger icon) and click on "Unlock". If you set a password in the options, enter your password and press enter.

But be warned: this is more a proof of concept at the moment!


Scenerixx VLC Bridge

The Scenerixx VLC Bridge is a crappy piece of software that lets you interact with Scenerixx from VLC within in a limited way.

You need to start the Scenerixx Hub. Within ScenerixxVlcBridge.lua you'll find several strings "http://localhost:7679" The 7679 is the port which has to be the same as the one Scenerixx Hub is running. Either you modify the lua script or you choose the port in the Options under "Scenerixx Hub / Port"

Within VLC you need to activate OSD so the plugin can give you feedback after each action.
Activate OSD under "Tools / Preferences / Subtitles/OSD / Enable On Screen Display (OSD)"

In the directory {scenerixx}/scenerixxvlcbridge you'll find a file ScenerixxVlcBridge.lua.
You need to copy this file into the plugin directory of VLC.
Where this directory is depends on the system.
VLC has officially several places where plugins can be placed:

For All Users
In Windows: Program Files\VideoLAN\VLC\lua\extensions\
In Linux: /usr/share/vlc/lua/extensions/

For Current User
In Windows: %APPDATA%\vlc\lua\extensions\
In Linux: ~/.local/share/vlc/lua/extensions/

I had to try several locations until I found something that worked out.

For me it was in:

~/.var/app/org.videolan.VLC/data/vlc/lua/extensions/ScenerixxVlcBridge.lua

If this all does not help you need to Google yourself for other possibilities.
Sorry.

Once the plugin is in the correct directory VLC have after a restart a new menu item under "View": "Scenerixx VLC Bridge".
You need to click this once to activate the plugin. After that you will be offered several menu items:

"Mark movie as favorite"
Marks a movie as favorite. If it is already marked as favorite nothing happens. Thus: the state is not toggled.

"Mark scene as favorite"
Marks a scene as favorite. In order to be able to flag the scene the scene must have a start and an end time set. Scenerixx uses the current runtime of the movie in VLC to determine the scene which should be flagged. If no scene matches nothing is done.

"I came"
Creates an I came bookmark for the current timetamp. Like in "Mark scene as favorite" the times of the scenes must be set.

"Add scene starting at current position"
Creates a new scene for the playing movie with the current timestamp as the starting time.

"Set end time for scene"
Sets the end time for the scene that was created before.

"Add bookmark starting at current position"
Adds a bookmark with the current runtime as a starting time. Like in "Mark scene as favorite" the times of the scenes must be set.

"Set end time for bookmark"
Sets the end time for the bookmark that was created before.

Before you can use the plugin you need to start the Scenerixx Hub from within Secenerixx.

Limitations
There are no shortcuts. VLC does not allow any for plugins.
There's no feedback in case of an error. You see those only in the logs.
And sometimes the whole plugin might crash.
The documentation for VLC plugins is ... not very exhaustive. To be honest I pretty much have no clue what I was doing there.


FAQ

First things first: why? Or: What's the history behind all of this?

Well, I love porn :)

There are great tools out there for everything. Your music collection, books, movies, whatever. But not for porn. At least not that I'm aware of. Within the years my collection grew and grew and with it the struggle to sort it / find something you were specifically looking for.
I'm not the kind of porn consumer who just fires up a streaming site, watch 10 minutes of something and clear my browser history after that.
Like music there is a certain mood for everything. Sometimes I'm looking specifically for a certain girl, a certain type of girl, a certain type of sex, sometimes a combination of all of those. Hell, sometimes I'm just having a movie playing on the second screen while working instead of listening to music.
We all know that the internet was made for porn, so there HAD to be something. Or? Sure, there are sites like iafd.com which I really appreciate and love (kudos to you guys), but are not helpful with my local collection. But that was exactly something I wanted.

After explaining the why, let's have a quick look at the history of my struggles which led to the current software.

And while I was at it, I was thinking: hey, this is cool and goes into the direction of what I wanted to have since years.
It would be awesome to have a search where I could exactly specify what I'm looking for. Like: today I'm in the mood for a scene with two girls, one in their early 20s, the other one at the end of their 30s together with one guy and I want to see some titty fucking, squirting and a creampie. And I want to see it at least in 1080p.

After a few weeks I realized two things:

a) That's a bunch of work to do. That comes not really at a surprise but while creating the movies, adding the scenes and then the persons to it is relatively fast done, putting all the search relevant details to all the scenes is such a massive amount of work that it would be a life's task.
Don't get me wrong. Even without a full-fledged search with all the bells and whistles and only basic search capabilities it's an invaluable tool to me.

b) This could be useful to other freaks like me.

This led to following thoughts:

As a developer it's always nice if your software is used by a lot of people. Of course there's no guarantee that anybody except me finds this useful. If this should be the case: fine by me. If it is useful to others: even better.
If it is useful to others maybe some people would contribute something back: data. No matter if person details, studios, movies or whatever data is needed to make this software more useful.
First I was thinking about a client/server architecture so that if a user enters e.g. data of a new person this data is send to a server and other clients can fetch and use this data.
But that would imply that I need a server which costs money and needs to be maintained (thus costing time). Beside that I would need to develop a algorithm that can handle for example merges, taking care about security and so on. Short: it would complicate a lot of things. Without knowing if it's worth the effort.
That's why (at the moment) everything is handled via (XML-like) files. You can export data, send the file to someone (for example me :) and the person can import those files on their site. It's not very comfortable but from a technical point of view very simple.
So, either I need more time or more money. Or better: both.
Beside not knowing if people would use this software another question arose: would people be willed to pay for a software like this? And then I stumbled across this article: Modder Makes Over $4,000 A Month Adding A Lot Of Sex To The Sims 4. Wow. That blow my mind. There was one guy making a living of a niche product. To be fair, I do believe that there's really a lot of work behind that.
But if I see that something like Yo, which was done in 8 hours, was valued between $5 and $10 million just 4 months after launching and enabled the developer to quit his job to work on this app full-time, I think that till now I was making something fundamentally wrong.
Since I spent a lot of hours (definitely more than 8) working on this product, I'll give it a shot, and try to make at least a few bucks out of it.
I spent a good deal of thinking about how to do it, like:

To be honest, I have no clue how to do it yet. So why do I write all of this? Just to be fair and tell you ahead that I'm thinking about monetizing this software. I guess in the future there will be a freemium model where a basic version will be free and a version with additional features will cost you something (like money, a cryptocurrency or you have to send me some new scenerixx-files, I don't know yet).

The most important part for the moment: Right now the software is free. Though donations are very welcome ;-)

Which operating systems are supported?

Theoretically Scenerixx will run under Linux, Windows and macOS.
Till now Scenerixx was tested only on Linux systems. Tests under Windows will follow shortly. Since I don't own a Mac I'm depended on people who own one and will give Scenerixx a shot.

Error: Cannot find Java 1.8 or higher

It can happen that you installed Java but Scenerixx is not finding the installation. In this case you can specify the installation path directly in the file {scenerixx}/etc/scenerixx.conf At the very end you insert the line: jdkhome="path/to/java"

The font sucks, can I change it?

In the options dialog you can change the look and feel.

There is a window missing.

You can open a window that you accidentally closed via the "Scenerixx"-menu or reset all windows with "Window / Reset Windows"

Which data Scenerixx will collect and what will happen with them?

Scenerixx will just index the folders you tell Scenerixx to index. The collected data will be saved in a database which is stored locally on your computer.
Scenerixx does not collect any data about your system, your collection, about crashreports or anything else. Also the website does not have any tracking tools installed.
At the moment only a few features (like managing tube movies or checking for a newer version) will need an internet connection (with probably more about to come).
At the moment you can use Scenerixx nearly completely offline.
If Scenerixx should ever collect personal data that should be shared with us we will ask you for your permission.

An error occurred - What should I do?

LIES! That's not possible. Just kidding. Scenerixx has several ten thousands lines of code, so I might overlooked something. In case an unexpected exception occurred, Scenerixx will open up a dialog to inform you what went wrong. Please be so kind and send me the information that is displayed under "Show and report problem". Scenerixx itself will *not* sent any information automatically. Add a small description what you were doing just before the error occurred. In case you could solve the problem with the provided error message please send me still the exception, so that I can handle it in future versions.
The log-files could be also helpful.
Also let me know if something is not working as expected even though no error is shown. Except the erratic behaviour is already listed in the FAQ.

How to get new data / importfiles?

Check the homepage and/or twitter-account for new importfiles and upload them into Scenerixx.

How to update Scenerixx?

As soon as you downloaded a new version of Scenerixx, just unpack the archive into a new folder and start the new version. The old directory of the old version can be deleted. Do NOT delete the directories "scenerixx" and ".scenerixx" in your home directory since they contain the database / configuration.

How to uninstall Scenerixx?

Scenerixx itself does not provide an uninstall-functionality. If you want to get rid of it, just delete the following three folders:

In case you configured some export directory or a "profile picture"-directory you might want to delete those too.

Where is the database stored and how to backup?

Scenerixx creates in your user directory a directory named "scenerixxdata" which contains the HSQLDB database. You can just copy this directory if you want to have a backup.

Where are the log-files stored?

Scenerixx creates in your user directory a hidden directory named ".scenerixx" which contains some configuration and log-files (under "var/log"). Usually you won't need to have a look into these (except for troubleshooting).

Which file types are supported?

Scenerixx recognizes following extensions for pictures: jpg, jpeg, gif, bmp, webp and png.
Recognized movie extensions: avi, mp4, mp7, mkv, mpeg, mpg, asf, divx, mov, f4v, flv, wma, mwv, m4v, iso, vid, rmvb, rm and mpe.

Why can you specify several person body data?

Some performers are long enough in the industry that they change visibly over the time. Either via operation or whatever. Have a look at Eden Adams for example.
That's why you can specify data about the body for each person several times. You can specify a time span which is not used currently but might be used in the future to select the right data for scene details if the date of shoot is known automatically.

What are differentiators for? (The dropdown with "+ = -")

Use the differentiator if a value is in between two values and it is hard to decide which one it is. E.g. if a body part is between "big" and "huge" you could choose either "big" with the "more" (+) differentiator or "huge" with the "less" (-) differentiator.
At the moment you cannot use differentiators as a search criteria.

What are ignore bookmarks?

If you want to skip a certain part within a scene you can use an ignore bookmark.
E.g.: A scene is 20 minutes long. And from 8:25 till 8:45 the scene is interrupted with some kind of story line or something like that, that you don't want to see. If you add an ignore bookmark to the scene with those exact times, the part will be skipped.
Note: at the moment it's not possible to skip within the video manually. As soon as you do the ignore bookmarks are getting ignored :-/

About "date of shoot" / "production dates"

You can provide a date on each movie/scene. This date is used to calculate the age of the persons. It's not always possible to find the exact date of the shooting. Usually if only production dates are stated I subtract two or three weeks and use the resulting month and year. So those dates should be taken with a grain of salt. The terms "date of shoot" and "production date" are therefore used quite broadly and interchangeable here, even though it's not correct.
Also be aware of compilations where scenes are not necessarily were shot in the same year. In those cases you can provide on each scene a different date.

What should I do if a movie split over several filed opens in the wrong order?

If you by accident associated mediumfiles in the wrong order to a movie you fix it either by removing the mediumfiles from the movie (in the context-menu of the movie) or you search for the mediumfiles in the " Medium Files"-window and change the value of "position" on every.

Why is there always another person shown at startup?

It's not a bug, it's a feature ;-) Seriously, over the time I was fed up seeing the same picture again and again while developing this application. Therefore I show with each start another (female) person.

What are secrets?

There are different entities which have a secret-flag, namely: Movies, Bookmarks, Persons and Playlists. If the secret-flag is set, those entities will only show up after you unlocked them (in the menu Scenerixx/ Unlock Secret Items). That allows you to let someone else browse your collection without worrying that the other one will see something you don't want him to see (homevideos of your wife, pictures of your hot neighbour, whatever).

The data that you provide in "Reminds me of" (at the person and scene entity) will always be treated as a secret.

WARNING: Secrets are only hidden in the application itself. If someone has access to the database they can see those secrets. Secrets are also not encrypted, even if you provide a password.

Secrets & Playlists

Secret items (movies & bookmarks) are tracked in a separate history playlist. What you should be aware of: If you start a movie which is not secret, it will be added to the normal history playlist. After making the movie a secret movie the history entry in the normal playlist remains! It will not be automatically converted to the secret history playlist. You can still delete it from the normal history playlist manually if you want.

Secrets & Persons

If a person is marked as secret and will be associated to a scene of a public movie the person will be shown in this scene.

Profile pictures

If you want to associate a picture to the person drag&drop a picture file from the " MediumFiles"-window to a person in the " Persons"-window. You might need to move one of the windows by clicking on their tab and drag it somewhere else so that you can see both windows at the same time.
If a picture is associated like this to a person the " Person Details"-window will always show this picture.
As an alternative you can define a directory in the options which will be searched for a corresponding file. The filename needs to start with the persons name. E.g. if you have a person named "Sasha Grey" the program will search this folder recursively to see if it finds a file which starts with this name. Files that would be found:

As you see, capitalization is ignored. Extensions can be .jpg, .jpeg, .png and .gif.
You can also include the string "nsfw" in the filename. In this case this file is preferred when the session is unlocked. E.g.

Is the session locked, "Sasha Grey.jpg" would be shown, is the session unlocked "sasha grey outside - nsfw.jpg". Except a picture was associated to the person in which case the associated picture will be shown.

Names that wouldn't work (because they don't match the name):

This won't work with persons who share the same name. In this case you need to associated the picture by yourself to the person to show the right picture.

On a last note: it can happen that the wrong image is shown if a name is very short and is contained in another name. E.g.:

Here it can happen, that the picture "Katja Kassin.jpg" is displayed even though we are on the detail page of "Kat".

Since Scenerixx 2.0.0 you can specify in the options another directory. The sub directories must be named like the persons, e.g.:

    profileRootDir
        |-Aurora Snow
        |-Bobbi Starr
        |-Jessa Rhoades

Inside each sub directory you can save as many pictures as you want and Scenerixx will display in random order a picture from one of the directories as the profile picture.

NOTE: it's not sufficient to set "Random profile picture directory" alone you must also specify a "Profile picture directory" even though it might not be used.

Studio logos

It's the same as a profile picture. Just save the studio along along with the other profile pictures (or in a separate sub-directory). If Scenerixx finds a picture that has the same name as a studio it will get displayed in the studio details window.

What is "Audio desync"?

Sometimes audio and video are not in sync. VLC offers the possibility to correct this behaviour. You can specify a value (positive or negative) in milliseconds to let VLC play your file correctly again. You can set this value either in the MediumFile-Window or in the Details-Window. In both cases the value is stored so that VLC will always pick up the value if you are starting the file from within the application so you don't have to be bothered with out-of-sync audio the next time anymore.

Note: this works quite good when the audio is behind. If the video is behind (you start a file and the video starts normally but there are some seconds cut off the audio-stream so that the audio is quite ahead of the video) VLC might run into some problems. A few milliseconds adjustment is fine. But I had problems when the audio was several seconds ahead of the video. In those cases VLC played just a few seconds and suddenly stopped. So, there might be nothing wrong with your provided value, but with VLC itself.

Tracking of deleted files

Scenerixx tracks the hashes of deleted files. If a previously deleted medium file is added again to the index this medium file is marked with a dedicated icon. The wizard ignores such files. Little drawback: if you delete a duplicate the remaining file still gets marked.

Why can't the application gather any information on it's own?

I know that a lot of information exists on the internet (iafd, data18, freeones, etc.) so why not scraping those sites?

First of all: if those sites change there layout, the scraper will be broken. Second: most sites do not allow a scraping. It's as simple as that.

After several hundred movies the program gets really slow. What can I do?

I know that Scenerixx can become quite unresponsive when you have already several hundred thousands movies in the database and you are creating new movies the movie tab is reloaded quite often (because of saving an entity, creating new ones, etc.). This got better in the past but it's still not completely fixed.

How to re-arrange the tabs?

Maybe you want to re-arrange the layout because of reasons. You can maxime/minimize a tab by double-clicking on it. If you drag& drop a tab you can place it somewhere else. You can also close tabs if you don't need them at the moment. If you closed a tab by accident you can open it via the menu again.

How to get in touch (because of bugs, feature requests, data, general feedback, etc.)?

If you want to get in touch with me drop me a line at [email protected] or contact me via twitter: https://twitter.com/scenerixx

Japanese and other 'strange' characters in filenames are not displayed correctly. Why?

If you are using MySQL you need to make sure that UTF8 is passed as encoding into the connection string. See use MySql.
This piece of information was missing in the documentation up to version 1.2.0.

Some look & feels display a heart / star after a node some not

Ratings usually have a heart as a suffix and ratings a star. Not all fonts that are used by the look & feels support those characters. Since Scenerixx 3.3.0 some fallback characters will be shown.

Under Linux VLC does not start. Why?

If VLC is installed as a snap Scenerixx detects VLC as installed but is not able to open any movies.
I was also not able to make it work to pass a filename from the command line to VLC. So as a workaround you need to install VLC as non-snap version at the moment.

VLC does not start anymore

I once had the problem that VLC was not starting anymore from within. The log showed something like this:

13:02:59.506 FINE [xxx.scenerixx.scenerixxmodule.windows.movie.MovieListTopComponent]: VLC Stdout: [0000560d1bf8efa0] [http] lua interface: Lua HTTP interface
13:02:59.507 FINE [xxx.scenerixx.scenerixxmodule.windows.movie.MovieListTopComponent]: VLC Stdout: [0000560d1bfe30d0] main interface error: no suitable interface module
13:02:59.507 FINE [xxx.scenerixx.scenerixxmodule.windows.movie.MovieListTopComponent]: VLC Stdout: [0000560d1bef6670] main libvlc error: interface "default" initialization failed
13:02:59.508 FINE [xxx.scenerixx.scenerixxmodule.windows.movie.MovieListTopComponent]: VLC Stdout: [0000560d1bf8efa0] [http] main interface error: socket bind error: Address already in use
13:02:59.508 FINE [xxx.scenerixx.scenerixxmodule.windows.movie.MovieListTopComponent]: VLC Stdout: [0000560d1bf8efa0] [http] main interface error: socket bind error: Address already in use
13:02:59.508 FINE [xxx.scenerixx.scenerixxmodule.windows.movie.MovieListTopComponent]: VLC Stdout: [0000560d1bf8efa0] [http] main interface error: cannot create socket(s) for HTTP host
13:02:59.508 FINE [xxx.scenerixx.scenerixxmodule.windows.movie.MovieListTopComponent]: VLC Stdout: [0000560d1bf8efa0] [http] lua interface error: Error loading script /usr/lib/x86_64-linux-gnu/vlc/lua/intf/http.luac: lua/intf/http.lua:336: Failed to create HTTP host

It might be that you need to switch the log level to 'finest' to see the log.
My solution was to execute

    vlc --reset-config

on the terminal. I have no clue how this happened. And it only happened once in six years. So probably you won't need it anytime soon.

How to contribute?

You want to help? Great! Create some scenerixx-files and send them to me. Let me know if you encounter a bug. Or if you are missing a feature (also if it's already listed in the roadmap section so I can triage them) or a predefined value. Spread the word. Tell it to your friends and/or mention it on any social media platform. Don't hesitate to report even small typos. Or just drop me a line saying "hi", so that I know if people are using this software or not.

Donations

You want to donate something (other than data)? Awesome: You can send me some Bitcoins to: 1EsvZXaeAmDxpRFVaGo7JysAVvFbgZGaUZ


Changelog

See Changelog


Roadmap, Known Issues & TODOs

Known issues

Roadmap

What's coming next?