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.
Latest revision Your text
Line 31: Line 31:
-
'''Lyrics'''
+
'''Lyrics display'''
-
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.
+
When enabled (in the general settings), '''OMP''' will download lyrics for the current song and cache them for offline use. Tap the cover art to toggle between the usual progress bar/playlist and the lyrics display. It's possible to edit lyrics with the built-in editor, which can be invoked from display's context menu. Lyrics are downloaded from http://lyrics.mirkforce.net and stored in "/home/user/.lyrics/".
-
 
+
-
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'''
'''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.
+
Simply invoke the context menu of a song and select "Share" to send it via either Bluetooth or email. Works for videos, too.
Line 52: Line 48:
'''Playlist editing'''
'''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.
+
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. The difference between "Now playing" and the playlist browser is that in the first case, changes are saved immediately, while in the latter they are preserved only after choosing "Save playlist" from the menu.
-
'''Easier playlist creation'''
+
'''Improved album art'''
-
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.
+
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.
'''Creating playlists from a folder'''
'''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.
+
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.
+
Line 88: Line 74:
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.
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'''===
==='''MP''' features, currently lacking in '''OMP'''===
 +
*Bookmarking video streams.
 +
*Playback uninterruptable by incoming messages.
 +
*Differentiation between audio and video when streaming (audio opens in the video window).
*Counting duration of playlists in the playlist browser.
*Counting duration of playlists in the playlist browser.
*...
*...
Line 106: Line 85:
===Known bugs:===
===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''')===
===Planned extra features (not present in '''MP''')===
-
*...
+
*Sleep timer
== Configuration ==
== Configuration ==
Line 118: Line 95:
=== General settings ===
=== 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.
+
The settings window is accessible from the titlebar menu of the main view. Some of the options might look mysterious 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.
+
Line 134: Line 106:
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''.
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.
 
Line 154: Line 121:
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.
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/ (only mostly complete translations are packaged with '''OMP'''). Effects of this option are visible only after restarting the application.
 
=== Making OMP the default media player ===
=== Making OMP the default media player ===
Line 171: Line 133:
This will replace execution of '''MP''' binary with '''OMP''' one - without physically replacing files, so You can revert back to '''MP''' by reverting changes.
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" |  
 
-
|-
 
-
| 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" |  
 
-
|-
 
-
| 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" |  
 
-
|-
 
-
| 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" |  
 
-
|-
 
-
| Ctrl+F              || List with filtering || Open search box and select text
 
-
|-
 
-
| Up, Down            || Search box          || Return focus to underlying list
 
-
|-
 
-
| colspan="3" |  
 
-
|-
 
-
| [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 ==
== Translations ==
'''OMP''' package comes with the following translations:
'''OMP''' package comes with the following translations:
-
*Arabic (Saudi Arabia),
 
-
*Bulgarian
 
*Czech,
*Czech,
*German,
*German,
Line 261: Line 146:
*Dutch,
*Dutch,
*Polish,
*Polish,
-
*Portuguese (Brazil),
 
-
*Portuguese (Portugal),
 
*Romanian,
*Romanian,
*Russian,
*Russian,
-
*Slovak
 
*Swedish,
*Swedish,
*Turkish,
*Turkish,
-
*Ukrainian,
 
*Chinese.
*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.
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]]
 

Learn more about Contributing to the wiki.


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!


Cancel | Editing help (opens in new window)