# &app; Manual V&manrevision;

## Introduction

The &app; application is a movie collection manager for the GNOME desktop.

&app; provides the following features:

- Play selected movie with your favorite video player.

- Manage various types of information for your movies such as: title, year, media type, quality, subtitles, location, genre, comment and movie image.

- Movie rating.

- Movie tags.

- Movie comment.

- Movie serch. Local and on ImDB.com.

- Export your movies to html or text document.

&app; also comes with additional functionalities such as Genre Editor and Movie Image Viewer.

&app; has a fast and light database based on XML.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

- Choose Sound & Video &app;

Command line

- To start &app; from a command line, type the following command, then press Return:

  `vmoviedb`

  To view other command line options that are available, type `vmoviedb --help`, then press Return.

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; Main Window

Shows &app; main window. Contains titlebar, menubar, toolbar, view pane, movie area, and statusbar. Menubar contains File, Edit, View ,Movie, Tools and Help menus.

Table 1 describes the components of &app; main window.

### &app; main window components.

Id | Component | Description
1 | Menubar | The menus on the menubar contain all of the commands you need to use in &app;.
2 | Toolbar | The toolbar contains a subset of the commands that you can access from the menubar.
3 | View Pane | The view pane displays information about all movies in your database and may contain the following columns: Title - display movie title Year - display movie release date or when no movie year is set display "N/A". Genre - display movie genre or when no movie genre is set display "N/A". Rating - display movie rating. Format - display movie file format such as avi, mpg or when no movie format is set display "N/A". Quality - display movie quality such as "Bad", "Good" or when no movie quality is set display "N/A". Subtitles - display "Yes" if movie have subtitles, "No" when movie don't have subtitles or "N/A" when no subtitles information is set. Playlist - enables you to select movies you want to play one after another.
4 | Movie Area | The movie area provide access to details about the currently selected movie.
5 | Statusbar | The statusbar displays the number of movies that your database contain.

Information presented in the View Pane as "N/A" means that the information is not available.

### The Movie Area

The movie area provide access to details about the currently selected movie. When no movie is selected this area is inactive. When movie is selected, the movie title, the movie genre, the tags under wich selected movie is listed, the movie database record, the movie image, the movie comment and the movie location are active.

#### &app; Movie Area

Shows &app; movie area.

You can show or hide the movie area by selecting View Movie Information Box or pressing F9 key.

Clicking on the movie title will open your default web browser and take you to the ImDB.com website, presenting you with information about the selected movie.

Clicking on the movie genre will show you all movies listed under the same genre as the currently selected movie. To display all movies again click on the Shows refresh button. button.

Clicking on some of the active movie tags will show you all movie listed under the selected tag.

When you click on active movie tag the tag information box (vmoviedb-tag-info-box) is displayed under the toolbar. To display all movies again close the box by clicking button.

##### Tag Information Box

Shows &app; tag information box.

Clicking on the movie image will start the Movie Image Viewer and will display the movie image in it's original size.

## Using &app;

### To Play Movie

To play movie select the movie you want to be played from the View Pane and then click on the "Play" button located on the toolbar. Doing this will present you with the "Play Movie dialog" (vmoviedb-play-dialog).

#### &app; Play Movie dialog

Shows &app; Play Movie dialog.

Play Movie dialog contains information for the movie you are about to play. Click the "Play" button to start playing or "Cancel" button to quit the dialog.

You can also play movie by selecting Movie Play from the menubar, pressing Ctrl P or you can click on the selected movie with the right mouse button and choose "Play" from the popup menu.

### To Add Movie

To add move click on the "Add movie" button located on the toolbar. Doing this will present you with the "Add Movie" dialog.

The "Add Movie" dialog has two tabs - "Movie details"(vmoviedb-add-dialog-main) and "Comment" (vmoviedb-add-dialog-comment).

#### &app; Add Movie dialog "Movie details" tab

Shows &app; Add Movie dialog "Movie Details" tab.

In the "Movie details" tab you can enter general information about the movie you want to add. Set the movie rating, location, tag categorization and image.

The title field is requied. You won't be able to add movie withought entering information in this field. All other fields and settings are optional.

#### &app; Add Movie dialog main section

Shows &app; Add Movie dialog "Comment" tab.

In the "Comment" tab you are able to enter comment for the movie.

You can save you comment to text document by clicking "Save to file" button.

To clear you whole comment click on the Shows clear button. button.

There are no restrictions about the comment lenght but it's recommeded to keep your comment's in the lenght between 0 and 5000 characters, for application preformance reasons.

To add your movie click on the "Add" button, or to cancel the operation click "Cancel" button.

You can also add movie by selecting Movie Add Movie from the menubar, pressing Ctrl M or you can use the popup menu accessible from view pane and select "Add Movie"

### To Edit Movie

To edit movie, select the movie you want to edit from the view pane and click "Edit movie" toolbar button. Doing this will present you with the "Edit movie" dialog.

The "Edit Movie" dialog has two tabs - "Movie Details"(vmoviedb-edit-dialog-main) and "Comment"(vmoviedb-edit-dialog-cm).

#### &app; Edit Movie dialog "Movie details" tab

Shows &app; Edit Movie dialog "Movie details" tab.

In the "Movie details" tab you can change general information about the selected movie. Ajust the movie rating, correct the location, change tag categorization and image.

The title field is requied. You won't be able to save your changes to the movie withought entering information in this field. All other fields and settings are optional.

#### &app; Edit Movie dialog "Comment" tab

Shows &app; Edit Movie dialog "Comment" tab.

In the "Comment" tab you are able to change or clear the movie comment.

You can save you comment to text document by clicking "Save to file" button.

To clear you whole comment click on the Shows clear button. button.

There are no restrictions about the comment lenght but it's recommeded to keep your comment's in the lenght between 0 and 5000 characters, for application preformance reasons.

To save the changes to the edited movie click the "Save" button, or to cancel the operation click "Cancel".

You can also edit movie by selecting Movie Edit Movie from the menubar, or you can use the popup menu accessible from view pane and select "Edit Movie"

### To Delete Movie

To delete movie select the movie you want to delete and click "Delete movie" toolbar button. You will be asked for confirmation. Click "Yes" to delete the movie or "No" to cancel the operation.

You can also delete movie by selecting Movie Delete Movie from the menubar, or you can use the popup menu accessible from view pane and select "Delete Movie"

### To Search For A Movie

To search for a movie in the movie database click "Find" toolbar button. Doing this will present you with the "Find" dialog (vmoviedb-find-dialog).

#### &app; Find dialog.

Shows &app; Find dialog.

Select the criteria by wich you want to do your search. Type the keyword in the entry and click "Find" button. If there are any movies maching the selected criteria they will be displayed in the list below the search box.

When you click with the right mouse button on some result from the search operation, a popup menu is displayed, from wich you can preform one of the listed operation on the result.

Table 2 describes the available movie search criterias and shows example for each of them.

### &app; find dialog search criterias.

Criteria | Description | Example usage
Title | Search for movie by it's title. | EXAMPLE: "R" will return all movies having "R" in their titles, "Rambo" will return all movies wich have that name in their titles.
Year | Search for movie by year. | EXAMPLE: "1994" will return all movies released in 1994.
Format | Search by format | EXAMPLE: "avi" will return all movies in avi format.
Quality | Search for mobie by it's quality. | EXAMPLE: "Good" will return all movie in the database listed to have a good quality.
Subtitles | Search for movie by subtitles. | EXAMPLE: "Yes" will return all movies having subtitles.
Genre | Search fot movie by it's genre. | EXAMPLE: "Comedy" will return wall movies listed under this genre.

&app; do not determin the movie quality by it self. The movie quality is set by the user and may not have the same values as shown in the search example.

### To Export Your Movies Database To HTML Document.

To export your movies database to an HTML document select File Export Export to HTML document from the menubar. Doing this will present you with the "Export to HTML document" (vmoviedb-html-dialog) dialog.

#### &app; Export to HTML document dialog.

Shows &app; Export to HTML document dialog.

In the "Header" field type the title of your document, in the "File name" field type the name of your document followed by ".html" extention. When you are redy press the "Export" button.

Message showing the result of the operation will be displayed.

### To Export Your Movies Database To Text Document

To export your movies database to text document select File Export Export to text document from the menubar. Doing this will present you with the "Export to text document"(vmoviedb-txt-dialog) dialog.

#### &app; Export to text document dialog.

Shows &app; Export to text document dialog.

In the "File name" field type the name of your document followed by ".txt" extention. When you are ready press the "Export" button.

Message showing the result of the operation will be displayed.

## Using &app; Genre Editor

### Genre Editor Introduction

Using the &app; Genre Editor the user can manage a collection of movie genres, and use them when adding or editing movie record as predefined templates accessible from the "Genre" field of "Add movie" or "Edit movie" dialogs.

#### &app; Genre Editor.

Shows &app; Genre Editor.

### To Add Genre

To add genre click on the "Add" button. Doing this will present you with the "Add genre"(vmoviedb-genre-editor-add) dialog.

#### Add genre dialog.

Shows add genre dialog.

In the "Genre name" field type the name of the genre you want to add, and then click on the "Add" button. If you want to cancel the operation click "Cancel"

### To Edit Genre

To edit genre, selectit from the genre list and click on the "Edit" button. Doing this will present you with the "Edit genre" (vmoviedb-genre-editor-edit) dialog.

#### Edit genre dialog.

Shows edit genre dialog.

In the "Genre name" field change the genre name as appropriate, and click on the "Save" button. If you want to cancel the operation click "Cancel".

### To Delete Genre

To delete genre, selectit from the genre list and click on the "Delete" button. You will be asked for confirmation click "Yes" to delete the selected genre or "No" to cancel the operation.

## Using &app; Movie Image Viewer

### Movie Image Viewer Introcuction

Using the &app; Movie Image Viewer user can view all movie covers in his/her database in actual size.

#### &app; Movie Image Viewer.

Shows &app; movie image viewer.

### Scrolling movies back and forward

To browse the movie covers in your database using the Movie Image Viewer use the "Back" and "Forward" buttons.

Pressing the "Back" button will go up in the movie list with one record, and pressing the "Forward" button will go down in the movie list with one record.

## Customizing &app;

You can customize &app; to suit your requirements and preferences. This section describes how to customize &app;

To customize &app; use the Preferences dialog. To display preferences dialog choose Edit Preferences.

### General Preferences

This section of the dialog allows you to set the default video player wich will be used, and to set if the "Play movie" dialog is visible or not.

#### General Preferences

Shows &app; general preferences.

### Movie List Preferences

This section of the dialog allows you to set wich movie list column will be displayed and the default action associated with movie list double click.

#### Movie List Preferences

Shows &app; movie list preferences.