Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/obfusk/m-gui
m - minimalistic media manager - GUI
https://github.com/obfusk/m-gui
gtk gui media mpv video vlc
Last synced: about 2 months ago
JSON representation
m - minimalistic media manager - GUI
- Host: GitHub
- URL: https://github.com/obfusk/m-gui
- Owner: obfusk
- License: gpl-3.0
- Created: 2018-09-11T04:48:28.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-10-01T15:21:29.000Z (over 6 years ago)
- Last Synced: 2024-11-14T22:44:25.243Z (2 months ago)
- Topics: gtk, gui, media, mpv, video, vlc
- Language: Python
- Homepage: https://obfusk.ch/m/
- Size: 138 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.GPLv3
Awesome Lists containing this project
README
File : README.md
Maintainer : Felix C. Stegerman
Date : 2018-09-16
Copyright : Copyright (C) 2018 Felix C. Stegerman
Version : v0.1.1
License : GPLv3+
[](https://pypi.python.org/pypi/mmm-gui)
[](https://travis-ci.org/obfusk/m-gui)
[](https://www.gnu.org/licenses/gpl-3.0.html)
## Description
m - minimalistic media manager - GUI
A minimalistic GUI for [m](https://github.com/obfusk/m).
## Examples
```bash
$ m-gui --stay-fullscreen --scale 2.0
```
## Help
```bash
$ m-gui --help # show options
$ m-gui --show-config # show configuration
```
## Requirements
Python >= 3.5, PyGObject, GTK+ 3,
[VTE](https://wiki.gnome.org/Apps/Terminal/VTE); and `m` of course.
## Installing
You can just put `m-gui.py` somewhere on your `$PATH` (in e.g.
`~/bin`; I suggest calling it `m-gui`, but you're free to choose
another name).
You may want to clone the repository instead of just downloading
`m-gui.py` to be able to get new versions easily.
Alternatively, you can install mmm-gui using pip (the Python package
manager) or build and install a Debian package.
NB: the pip and Debian packages are called `mmm-gui` instead of
`m-gui`.
### Using git
```bash
$ cd /some/convenient/dir
$ git clone https://github.com/obfusk/m-gui.git obfusk-m-gui
$ cd ~/bin # or some other dir on your $PATH
$ ln -s /some/convenient/dir/obfusk-m-gui/m-gui.py m-gui
```
Updating:
```bash
$ cd /some/convenient/dir/obfusk-m-gui
$ git pull
```
### Using pip
```bash
$ pip3 install --user mmm-gui # for Debian; on other OS's you may need
# pip instead of pip3 and/or no --user
```
### Building a Debian package
```bash
$ sudo apt install debhelper dh-python pandoc # install build dependencies
$ sudo apt install python3-gi libgtk-3-0 libvte-2.91-0 # run dependencies
$ cd /some/convenient/dir
$ git clone https://github.com/obfusk/m-gui.git obfusk-m-gui
$ cd obfusk-m-gui
$ dpkg-buildpackage
$ sudo dpkg -i ../mmm-gui_*_all.deb
```
## Configuration File
You can configure some settings in `~/.obfusk-m/gui.json`. To see the
current configuration, run:
```bash
$ m-gui --show-config
```
NB: some (non-gui-specific) options -- like using `mpv` as player --
are better configured via `config.json`; see the documentation of `m`
for more information.
### Bookmarks
NB: since bookmarks are saved in `gui.json`, adding a bookmark from
the GUI will open and re-save this file. Formatting is thus not
preserved, data should be (unless you happen to trigger a race
condition by writing to this file in between loading and saving by the
GUI).
```json
{
"bookmarks": [
"/some/media/dir",
"/some/other/media/dir"
]
}
```
### Defaults
```json
{
"scale": 2.0,
"stay_fullscreen": true
}
```
### Adding commands
```json
{
"add_commands": [
[
"mark-and-next space _Mark Playing and Play Next"
]
],
"scripts": {
"mark-and-next": "#{M} mark playing && #{M} next"
}
}
```
### m options
```json
{
"m_options": {
"colour": true,
"ignorecase": true,
"numeric-sort": true,
"show-hidden": true
}
}
```
### m command
```json
{
"m_command": "mmm"
}
```
NB: the command is passed to the shell, so you'll need to escape/quote
special characters (including spaces) appropriately; be careful!
## TODO
* update README + version (4x + dch) + package (deb + pip)!
* `ack TODO`
* also allow setting --numeric-sort etc. on the fly
- checkboxes in gui?
- --options passed through to m?
* handle exceptions better.
* document, test!?; screenshot?
* use shell "m ..." only if no need to quote?!
* running w/ `python3 -Wd` results in DeprecationWarnings
- Vte.Terminal.spawn_async not yet available
## License
[](https://www.gnu.org/licenses/gpl-3.0.html)
## Links
* [GTK+ key names](https://github.com/GNOME/gtk/blob/master/gdk/keynames.txt)
for key bindings like `q`.