nncmpp/README.adoc

73 lines
2.5 KiB
Plaintext
Raw Normal View History

nncmpp
======
2016-10-01 21:16:16 +02:00
'nncmpp' is yet another MPD client. It is in effect a simplified TUI version
of Sonata. I had already written a lot of the required code before, so I had
the perfect opportunity to get rid of the unmaintained Python application and
make the first TUI client that doesn't feel awkward to use.
2016-10-01 21:16:16 +02:00
If it's not obvious enough, the name is a pun on all those ridiculous client
names, and should be pronounced as "nincompoop".
2016-10-03 01:36:42 +02:00
Features
--------
2018-10-21 04:27:00 +02:00
Most things are there. Enough for me to use it exclusively. Note that since I
only use the filesystem browsing mode, that's also the only thing I care to
implement for the time being.
2016-10-03 01:36:42 +02:00
image::nncmpp.png[align="center"]
Packages
--------
Regular releases are sporadic. git master should be stable enough. You can get
2018-06-24 04:29:47 +02:00
a package with the latest development version from Archlinux's AUR.
2020-10-26 13:24:46 +01:00
Documentation
-------------
See the link:nncmpp.adoc[man page] for information about usage.
The rest of this README will concern itself with externalities.
Building
--------
Build dependencies: CMake, pkg-config, asciidoctor, liberty (included),
termo (included) +
Runtime dependencies: ncursesw, libunistring, cURL
2018-06-24 04:29:47 +02:00
$ git clone --recursive https://git.janouch.name/p/nncmpp.git
$ mkdir nncmpp/build
$ cd nncmpp/build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
$ make
To install the application, you can do either the usual:
# make install
Or you can try telling CMake to make a package for you. For Debian it is:
$ cpack -G DEB
# dpkg -i nncmpp-*.deb
2016-10-03 01:36:42 +02:00
Terminal caveats
----------------
This application aspires to be as close to a GUI as possible. It expects you
to use the mouse (though it's not required). Terminals are, however, somewhat
tricky to get consistent results on, so be aware of the following:
- use a UTF-8 locale to get finer resolution progress bars and scrollbars
- Xterm needs `XTerm*metaSendsEscape: true` for the default bindings to work
- urxvt's 'vtwheel' plugin sabotages scrolling
Contributing and Support
------------------------
2018-06-24 04:29:47 +02:00
Use https://git.janouch.name/p/nncmpp to report any bugs, request features,
or submit pull requests. `git send-email` is tolerated. If you want to discuss
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
2018-06-24 04:29:47 +02:00
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
2017-06-03 23:02:53 +02:00
License
-------
This software is released under the terms of the 0BSD license, the text of which
is included within the package along with the list of authors.