Editing Open Media Player

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

'''Open Media Player''' (referred to as '''OMP''' from now on) is an effort to recreate (closed source) stock '''Media Player''' (referred to as '''MP''', from now on) for [[Maemo]] platform, as Open Software. The main goal of the project is to include all features of '''MP''' without it's bugs, at the same time having the ability to extend functionality, when desired and appropriate.

'''OMP''' is currently in beta stage, so it may not be ready for end-users. However, brave souls (power-users, testers, developers) are encouraged to test it and participate in the development, by either submitting patches, or pointing out bugs/proposed features. '''OMP''' is on it's way to be included in the testing branch of [[CSSU]].

'''OMP''' can be installed from repositories: [[extras-devel]].

'''OMP''' got its thread on http://talk.maemo.org/showthread.php?t=72156 (discussion, reporting bugs, proposing features, etc.).

Changelog for the latest version of '''OMP''' is available from http://maemo.org/packages/view/openmediaplayer/.

== Features ==

==='''OMP''' extra features (not found in '''MP''')===

'''Portrait mode'''

The name speaks for itself: turn the device to rotate the interface. Automatic orientation can be disabled in the settings menu.

'''Entertainment View'''

An alternate view where elements from the regular "Now Playing" view are animated.

'''Car View'''

A finger-friendly view for use when driving. Tap the center of the screen to show the clock and swipe from right to left to show the playlist.

'''Lyrics'''

When enabled (in the general settings), '''OMP''' will download lyrics for the current song and cache them for offline use. Lyrics are provided by plugins and more than one of them can be enabled at the same time. If multiple plugins are active, the first one in the list will try to fetch lyrics, if it fails then the second, and so on. Tap the cover art to toggle between the usual progress bar/playlist and the lyrics display. It's possible to add missing lyrics and modify existing with the built-in editor, which can be invoked from lyrics' context menu.

Before the update of '''3th Aug 2012''', lyrics were stored in "/home/user/.lyrics/". They cannot be simply moved to the new location, because the naming convention has changed, but that doesn't make them completely useless. OMP has a plugin called ''OMP pre-20120803 offline cache'', which will search for lyrics also in the old directory (and save them in the new), so don't forget to turn it on if you don't want to start afresh.

To manually insert lyrics into the cache, put them in "/home/user/.cache/openmediaplayer/lyrics/Artist's Name/Title of the Song.txt" (note case sensitivity).

'''Easy way to share files'''

Simply invoke the context menu of a song and select ''Share'' to send it via either Bluetooth or email. Works for videos, too.

'''Configurable size of automatic playlists'''

The number of songs can be changed in the general settings. If set to a large number, it works like sorting the whole library by popularity, last time played or from recently added to old.

'''Playlist editing'''

It appears in two places: "Now playing" and the playlist browser. To move an item, double-tap it, but, hold after the second touch (so it's more like one and a half tap) and drag it to the desired position.

'''Easier playlist creation'''

In many places you will find an option called ''Add to a playlist'', which allows you to append songs to an arbitrary playlist. It's also useful for cloning and combining playlists.

'''Creating playlists from a folder'''

To use this feature, check ''Open whole folders'' in the general settings. When enabled, opening a song with a file browser (like the stock one or FileBox) will not only play that song, but also enqueue other songs from the same directory.

'''Restoring the music playlist'''

It is easily possible to return to the music playlist after watching a movie or listening to radio. It can be accomplished by long-pressing the playback indicator in the bottom right corner of the screen and selecting ''Music'' from the context menu.

'''Improved album art'''

The first thing you will notice is probably the reflected cover, but what is more important, '''OMP''' will detect files named "front.jpg" and "folder.jpg" (in addition to standard "cover.jpg"). Moreover, it is possible to choose any other file, using "Select album art" from cover's context menu.

'''Reverse time'''

This is hard to notice, because the only way to turn it on is to click a label which shows playback progress (on the left of a progress bar). When enabled,  time is counted from the end of a track, instead of from the beginning. Works both for movies and songs.

'''Headset button'''

Open Media Player has support for "phone" button on wired jack headset. In configuration dialog it is possible to select an action to be performed when the button is pressed. This feature does not even require any additional applications/packages (like headset-button-enabler or headset-control).

'''Searching without sliding out the keyboard'''

You can open the search box by sliding your finger up from the very bottom of the screen. When it pops out, do what you would do with any other text field (click on it to show the on-screen keyboard). Very useful for portrait mode or if you're too lazy to use the physical keyboard.

'''Customizable action on exit'''

Closing '''MP''' usually results in stopping the music. However, in '''OMP''' it's also possible to pause the music or even keep it going with the player closed. Configurable in the settings window.

'''Sleep timer'''

The sleep timer makes it possible to automatically pause/stop playback or close the application (with respect to the closing action selected in the main settings) after a selected number of minutes. Moreover, it supports two variants of volume reduction: linear, which decreases the volume level in equal intervals and exponential, which starts gently, but speeds up as approaches the timeout. Volume level can be changed freely when the sleep timer is in effect ‌– reduction rate will be adjusted to keep the chosen characteristic and reach 0 at the end (but in reality the sound already goes mute at ~4%). Available from the main window's menu.

==='''MP''' features, currently lacking in '''OMP'''===

*Counting duration of playlists in the playlist browser.
*...

===Known bugs:===

*''Headset button action'' does not work properly if ''Prevent playback interruptions'' is enabled.
** This is bug in Maemo system, not in OMP. Bug is already fixed in CSSU, do update. -- Pali
*...

===Planned extra features (not present in '''MP''')===

*...

== Configuration ==

=== General settings ===

The settings window is accessible from the titlebar menu of the main view. Some of the options might look mysterious (there's not enough space for more elaborate names) and this is why their meanings are explained here.

'''Continuous video playback'''

When a movie ends in '''MP''', playback stops and the video window is closed. This is also the default behavior of '''OMP''', but checking this option allows the next video in the playlist to be started automatically. Items in the playlist are ordered in the same way as they were displayed in the window from which the video was selected for playing.

'''Open whole folders'''

Controls the behavior when another program (like a file browser) tells '''OMP''' to open a song. When this option is disabled, only the selected song is opened. When enabled, also other songs from the same directory are added to the playlist. In other words, a playlist for the whole folder is created. This works non-recursively, i.e. subdirectories are not included.

'''Append opened songs'''

Another option related to cooperation with other applications. By default, when the player is ordered to open a song, current tracks are cleared and the song is added to a fresh playlist. Enabling this options skips the clearing procedure, so the selected song is added to the end of the playlist, leaving other tracks intact. Works together with ''Open whole folders''.

'''Prevent playback interruptions'''

In older versions of '''OMP''' each time an SMS or an IM arrived, the music was abruptly silenced, the notification sound was played and then the volume for music was restored. It makes the events harder to miss, but at a cost of unpleasant gaps in the music. This options allows you to choose between the described behavior and uninterrupted music with a quiet beep each time something happens.

'''Lazy sliders'''

With eager sliders, song/movie progress is adjusted immediately to the slider position. With the lazy option, playback position is changed after releasing the slider. The latter is smoother, but does not provide immediate preview.

'''"Delete" for playlist items'''

Turning this option on extends context menus of song lists in the playlist browser and ''Now playing'' by adding an action called ''Delete''. It provides a way to permanently delete a song (so the file is removed from the device), next to the soft ''Delete from playlist/now playing''.

'''Override FMTX checks in UI'''

Standard FM transmitter daemon does not allow transmitting with headphones or a USB cable plugged in, but this is not the case with jacekowski's modified FMTXD. If you have it installed, enabling this options skips the checking procedure, so nothing stands in the way to turn the transmitter on.

'''Force language code'''

If for some reason you don't want to use the automatically loaded translation, you can force a language by putting a language code in the input box. To auto-detect your language, just leave the box empty. For a list of available translations and their language codes visit http://www.transifex.net/projects/p/gidzzz-qt-mediaplayer/. Effects of this option are visible only after restarting the application.

=== Making OMP the default media player ===

As [[root]], edit file:
:''/usr/share/dbus-1/services/com.nokia.mediaplayer.service''
so the line:
<pre>Exec=/usr/bin/mediaplayer</pre>

...becomes:
<pre>Exec=/usr/bin/openmediaplayer</pre>

This will replace execution of '''MP''' binary with '''OMP''' one - without physically replacing files, so You can revert back to '''MP''' by reverting changes.

== Controls ==

{| class="wikitable" border=1
! Shortcut !! Context !! Action
|-
| Backspace           || Almost everywhere               || Close
|-
| Left, Right, Up, Down, Enter || List                   || Navigate
|-
| Q           || Main menu                   || Browse music
|-
| W           || Main menu                   || Browse videos
|-
| E           || Main menu                   || Browse streams
|-
| R           || Main menu                   || Shuffle all
|-
| Left, Right || Main menu                   || Select UPnP share
|-
| colspan="3" | &nbsp;
|-
| Ctrl+Enter  || List with context menu, Now Playing (music/lyrics) || Show context menu
|-
| Shift+Enter || Window with menu       || Show window menu
|-
| Y           || Confirmation dialog    || Yes
|-
| N           || Confirmation dialog    || No
|-
| colspan="3" | &nbsp;
|-
| Ctrl+Left  || Window with playback indicator	|| Previous track
|-
| Ctrl+Right || Window with playback indicator	|| Next track
|-
| Ctrl+L     || Window with playback indicator	|| Open Now Playing
|-
| Space      || Window with playback indicator, || Toggle playback
|-
| colspan="3" | &nbsp;
|-
| Left	              || Now Playing (music, radio) || Previous track
|-
| Right	              || Now Playing (music, radio) || Next track
|-
| Space               || Now Playing                || Toggle playback
|-
| Ctrl+L || Now Playing (music, video) || Change view
|-
| Ctrl+Shift+L || Now Playing (music) || Change view (backwards)
|-
| Left, Right, Up, Down || Now Playing (video) || Seek
|-
| S          || Now Playing (music, radio) || Stop playback
|-
| E          || Now Playing (music)        || Toggle shuffle mode
|-
| R          || Now Playing (music)        || Toggle repeat mode
|-
| colspan="3" | &nbsp;
|-
| Ctrl+F              || List with filtering || Open search box and select text
|-
| Up, Down            || Search box          || Return focus to underlying list
|-
| colspan="3" | &nbsp;
|-
| [swipe from bottom] || List with filtering || Open search box
|-
| [press and hold]    || Playback indicator  || Switch to music playlist
|-
| [press and hold]    || Play button (music, radio) || Stop playback
|}

== Translations ==

'''OMP''' package comes with the following translations:
*Arabic (Saudi Arabia),
*Bulgarian
*Czech,
*German,
*Spanish,
*Finnish,
*French,
*Hungarian,
*Italian,
*Dutch,
*Polish,
*Portuguese (Brazil),
*Portuguese (Portugal),
*Romanian,
*Russian,
*Slovak
*Swedish,
*Turkish,
*Ukrainian,
*Chinese.

If you want to check the current progress or join the efforts to translate '''OMP''' to more languages and improve existing translations, visit Transifex (http://www.transifex.net/projects/p/gidzzz-qt-mediaplayer/resource/openmediaplayer/). When a translation becomes complete enough (something about 90%), it will be included in the official package.
-----

[[Category:Software]]
[[Category:Qt]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "http://wiki.maemo.org/Open_Media_Player"

Personal tools

Navigation

Views

Editing Open Media Player

@@ Line 158: / Line 158: @@
 '''Force language code'''
-If for some reason you don't want to use the automatically loaded translation, you can force a language by putting a language code in the input box. To auto-detect your language, just leave the box empty. For a list of available translations and their language codes visit http://www.transifex.net/projects/p/gidzzz-qt-mediaplayer/ (only mostly complete translations are packaged with '''OMP'''). Effects of this option are visible only after restarting the application.
+If for some reason you don't want to use the automatically loaded translation, you can force a language by putting a language code in the input box. To auto-detect your language, just leave the box empty. For a list of available translations and their language codes visit http://www.transifex.net/projects/p/gidzzz-qt-mediaplayer/. Effects of this option are visible only after restarting the application.
 === Making OMP the default media player ===