238 lines
7.1 KiB
Markdown
238 lines
7.1 KiB
Markdown
|
|
# Rage
|
|
|
|
-----
|
|
|
|
*Please report bugs/issues at*
|
|
[git.enlightenment.org](https://git.enlightenment.org/enlightenment/rage/issues)
|
|
|
|
-----
|
|
|
|
This is a Video + Audio player along the lines of mplayer. It's simple
|
|
yet decent looking. It finds album art for you for music files,
|
|
generates thumbnails for videos so you can select logaction by
|
|
thumbnail and more. It accepts file lists on the cmdline ala:
|
|
```sh
|
|
rage file1.mp3 file2.mp3 file3.avi file4.mp4 file5.ogg
|
|
rage dvd:/
|
|
rage http://www.blah.com/stream
|
|
```
|
|
|
|
You can also specify subtitle files with -sub:
|
|
```sh
|
|
rage file.mp4 -sub mysubs.srt
|
|
```
|
|
|
|
And of course you can run it with no arguments:
|
|
```sh
|
|
rage
|
|
```
|
|
|
|
Which goes into "Browser mode" where Rage will index/list your
|
|
~/Videos directory as a library (and subdirectories).
|
|
|
|
This depends on video engine support to display them, so it may not
|
|
work. You might have toinstall more codec plugins for Gstreamer. Also
|
|
Rage will use a srt or sub format file if found, automatically. If the
|
|
filename is video.mp4 or video.avi, video.mov etc. then Rage looks for
|
|
video.srt or video.sub and automatically will use it.
|
|
|
|
If you DND files onto its window, they are added to the playlist.
|
|
Mouse over the right of the window brings up the playlist. Mouse over
|
|
the position bar at the bottom, if it's a video, brings up a video
|
|
thumbnail of that position (it may take a while to generate thumbnails
|
|
for that video - they are cached).
|
|
|
|
If you run Rage without arguments at all it goes into "browser" mode
|
|
where it will index all your media files in "$HOME/Videos" or whatever
|
|
you have configured your XDG video directory to be. It will flatten
|
|
out all directories that it recursively scans in this videos director
|
|
with a header with the directory name and a list of images per video
|
|
and the filename with extensions removed. It will either generate a
|
|
series of images to flip as the video thumb or may actually search for
|
|
a poster file dependig on length of video file (if it is more than 60
|
|
minutes long and less than 5 hours and the image ratio is between 4:3
|
|
and 4:1 it'll be assumed to be a movie for example). So while it is
|
|
fetching or generating thumbnails for the first time, be a little
|
|
patient. They will be cached so they only need to be generated or
|
|
fetched once (or if the file changes).
|
|
|
|
-----
|
|
|
|
Things that need doing:
|
|
|
|
[TODO](TODO.md)
|
|
|
|
-----
|
|
|
|
## Key controls
|
|
|
|
It's fully key controlled too. Key controls are:
|
|
|
|
| KEY | Action
|
|
| ----------------|----------------------------------------------------------
|
|
| Left | rewind or DVD nav left
|
|
| [ | rewind
|
|
| Right | fast forward or DVD nav right
|
|
| ] | fast forward
|
|
| Up | Volume up or DVD nav up
|
|
| + | Volume up
|
|
| = | Volume up
|
|
| Down | Volume down DVD nav down
|
|
| - | Volume down
|
|
| space | Pause toggle
|
|
| Pause | Pause toggle
|
|
| p | Pause toggle
|
|
| XF86AudioPlay | pause toggle
|
|
| s | Stop
|
|
| XF86AudioStop | Stop
|
|
| BackSpace | Stop
|
|
| Delete | Stop
|
|
| c | Stop but don't exit playback
|
|
| PgUp | Previous file
|
|
| XF86AudioPrev | Previous file
|
|
| PgDn | Next file
|
|
| XF86AudioNext | Next file
|
|
| Home | First file
|
|
| End | Last file
|
|
| m | Mute toggle
|
|
| XF86AudioMute | Mute toggle
|
|
| l | Loop 1 mode toggle
|
|
| q | Exit
|
|
| Escape | Exit
|
|
| f | Fullscreen toggle
|
|
| F11 | Fullscreen toggle
|
|
| n | Normalize window size to video size
|
|
| \ | Toggle File list or browser mode depending on launch mode
|
|
| y | Video low quality toggle
|
|
| z | Video zoom fit/fill modes toggle
|
|
| e | Eject file/media
|
|
| Return | DVD nav select
|
|
| Enter | DVD nav select
|
|
| , | DVD nav angle prev
|
|
| < | DVD nav angle prev
|
|
| . | DVD nav angle next
|
|
| > | DVD nav angle next
|
|
| Tab | DVD nav force
|
|
| 0 | DVD nav 0
|
|
| 1 | DVD nav 1
|
|
| 2 | DVD nav 2
|
|
| 3 | DVD nav 3
|
|
| 4 | DVD nav 4
|
|
| 5 | DVD nav 5
|
|
| 6 | DVD nav 6
|
|
| 7 | DVD nav 7
|
|
| 8 | DVD nav 8
|
|
| 9 | DVD nav 9
|
|
| ` | DVD nav 10
|
|
| ~ | DVD nav 10
|
|
| F1 | DVD nav menu 1
|
|
| F2 | DVD nav menu 2
|
|
| F3 | DVD nav menu 3
|
|
| F4 | DVD nav menu 4
|
|
| F5 | DVD nav menu 5
|
|
| F6 | DVD nav menu 6
|
|
| F7 | DVD nav menu 7
|
|
|
|
-----
|
|
|
|
## Requirements
|
|
|
|
* [efl](https://git.enlightenment.org/enlightenment/efl)
|
|
|
|
-----
|
|
|
|
## Compiling and Installing
|
|
|
|
Meson is the build system used for this project. For more information
|
|
please see [mesonbuild.com](https://mesonbuild.com)
|
|
|
|
You will need normal build tooling installed such as a compiler (gcc
|
|
or clang for example), pkg-config, ninja, any relevant package-dev or
|
|
package-devel packages if your distribution splits out development
|
|
headers (e.g. libc6-dev) etc.
|
|
|
|
Depending on where dependencies (like efl) are installed, you might have to
|
|
set your `PKG_CONFIG_PATH` environment variable like:
|
|
```sh
|
|
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/lib/pkgconfig
|
|
```
|
|
|
|
Also note that some distributions like to add extra arch directories
|
|
to your library locations so you might have to have more like:
|
|
```sh
|
|
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig:/usr/local/lib/x86_64-linux-gnu/pkgconfig:/usr/lib/pkgconfig:/usr/lib64/pkgconfig:/usr/lib/x86_64-linux-gnu/pkgconfig
|
|
```
|
|
|
|
You will need to ensure that the destination library directory (e.g.
|
|
`/usr/local/lib` is in your /etc/ld.so.conf or /etc/ld.so.conf.d/
|
|
files and after installing anything that installs libraries you
|
|
re-run `ldconfig`. Please see relevant documentation on ldconfig and
|
|
ld.so.conf for your distribution.
|
|
|
|
You might also want to add the destination bin dir to your environment
|
|
variable PATH (see documentation on your shell PATH variable) such as:
|
|
```sh
|
|
export PATH=/usr/local/bin:/usr/bin:/bin
|
|
```
|
|
|
|
Normal compilation in /usr/local:
|
|
```sh
|
|
meson . build
|
|
ninja -C build
|
|
sudo ninja -C build install
|
|
```
|
|
|
|
For meson build generic options:
|
|
```sh
|
|
meson --help
|
|
```
|
|
|
|
For a list of project specific options supported:
|
|
```sh
|
|
cat meson_options.txt
|
|
```
|
|
|
|
To set 1 or more project specific options:
|
|
```sh
|
|
meson --prefix=/path/to -Doption=value [-Dother=value2] [...] . build
|
|
```
|
|
|
|
To display current configuration:
|
|
```sh
|
|
meson configure build
|
|
```
|
|
|
|
The above will only work after at least the following is done:
|
|
```sh
|
|
meson . build
|
|
```
|
|
|
|
### Quick build help
|
|
|
|
How to clean out the build and config and start fresh:
|
|
```sh
|
|
rm -rf build
|
|
```
|
|
|
|
How to make a dist tarball and check its build:
|
|
(must do it from git tree clone and commit all changes to git first)
|
|
```sh
|
|
ninja -C build dist
|
|
```
|
|
|
|
How to change prefix:
|
|
```sh
|
|
meson --prefix=/path/to/prefix . build
|
|
```
|
|
|
|
How to install in a specific destination directory for packaging:
|
|
```sh
|
|
DESTDIR=/path/to/destdir ninja -C build install
|
|
```
|
|
|
|
How to build with verbose output (full commands run):
|
|
```sh
|
|
ninja -C build -v
|
|
```
|