---
name: "ogle"
section: "1"
platform: "linux"
package: "ogle"
version: "0.9.2-5.2"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/ogle"
---

# ogle(1)

DVD player with support for DVD menus

## NAME

ogle - DVD player with support for DVD menus

## SYNOPSIS

**ogle** \[**--check**\] \[**--debug**\] \[**-u \<cli\|gui\>** \[*path*\]\]

## DESCRIPTION

Ogle is an open source DVD player that supports DVD menus and navigation. You should be able to play DVDs directly from the DVD drive, a mounted fs, an image file or a copy on your hard drive.\
 Keyboard commands are available for navigation if you have  input focus in the video window.

See the [oglerc(5)](/oglerc/5.md) man page or /usr/share/ogle/oglerc for keybindings.

Screen shots can be saved in Ogle's current working directory as  screenshoot.jpg.\
 If you run xscreensaver it will be deactivated every 50 seconds  (don't use a timeout less than this ;)

## OPTIONS

- **--check**

  Runs a few checks on the dvd setup and exits

- **--debug**

  This enables output of extensive debug information. Use this when sending bug reports.

- **--debug-\<all\|audio\|cli\|ctrl\|gui\|mpeg\_ps\|mpeg\_vs\|nav\|vout\>**

  These make the specified part(s) of Ogle run inside a GDB (The GNU Debugger) session. This can be useful for tracing and crash examination.

- **-u cli** \[*path*\]

  Start Ogle without the graphical user interface.  This is the default if  the graphical user interface has not been installed. If *path* is given it attempts to use that as the root of the DVD to play.  If it's left out it defaults to /dev/dvd.

- **-u gui** \[*path*\]

  Start Ogle with a graphical user interface.  This is the default if  the graphical user interface has been installed. If *path* is given it attempts to use that as the root of the DVD to play and begins playback immediately.

- The -u options are (of course) mutually exclusive.

  ## ENVIRONMENT VARIABLES

- USE\_FFB2\_YUV2RGB

  If you run Ogle on Solaris and have a FFB2 frame buffer (a Creator 3D)  then you can use its hardware yuv2rgb to gain faster playback speed.  This  is still experimental code, so be warned.  It is enabled by setting the  environment variable USE\_FFB2\_YUV2RGB.

- OGLE\_MLIB\_SCALEMODE

  If mlib is used for scaling of video, OGLE\_MLIB\_SCALEMODE will decide which type will be used. The available options are:\
   NEAREST, BILINEAR, BICUBIC and BICUBIC2.

- OGLE\_USE\_XV

  If set to 0, it disables the use of the XVideo extension.

- OGLE\_USE\_XSHM

  If set to 0, it disables the use of the XShm extension.

- OGLE\_OSS\_RESET\_BUG

  If set, enables a workaround for buggy OSS audio drivers. It closes/reopens the audio device instead of resetting it when changing audio parameters.

- OGLE\_OSS\_TEST

  When set, a few tones will be output in each audio channel every time the audio parameters change and the OSS audio output driver is used.

## FILES

/usr/share/ogle/oglerc\
 $HOME/.oglerc

## SEE ALSO

[oglerc(5)](/oglerc/5.md)

## NOTE

For more information please visit http://www.dtek.chalmers.se/~dvd/

## AUTHORS

Björn Englund \<d4bjorn@dtek.chalmers.se\>\
 Håkan Hjort \<d95hjort@dtek.chalmers.se\>\
 Vilhelm Bergman \<d96v@dtek.chalmers.se\>\
 Martin Norbäck \<d95mback@dtek.chalmers.se\>\
 with contributions from many others on the net.

## BUGS

Please report bugs to \<dvd@dtek.chalmers.se\>.

## COPYRIGHT

This is free software; see the source for copying conditions.  There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.