Compare commits
34 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
b4222365c3
|
|||
|
b5e48c29f9
|
|||
|
eaa19be1c8
|
|||
|
dad95ef444
|
|||
|
7e74d1a80a
|
|||
|
8529f24a46
|
|||
|
190e813d49
|
|||
|
9af74259d2
|
|||
|
9a996c8440
|
|||
|
a9d4f86493
|
|||
|
172ceffa9e
|
|||
|
6dad74f3c9
|
|||
|
b196ef4f08
|
|||
|
d82be07807
|
|||
|
2d219f1a4b
|
|||
|
a77d872e7f
|
|||
|
179e0a123b
|
|||
|
da14bdbd39
|
|||
|
24e57872d8
|
|||
|
a20e4c74d8
|
|||
|
d33c17b888
|
|||
|
6033f6a869
|
|||
|
88e86724c3
|
|||
|
92c1bf783f
|
|||
|
435485d145
|
|||
|
d876bbfcd3
|
|||
|
1c37b15253
|
|||
|
2803a8153b
|
|||
|
f1ab0e2d8a
|
|||
|
830a744a11
|
|||
|
8260842aef
|
|||
|
fe017b4daa
|
|||
|
f3c4cec24a
|
|||
|
410136a647
|
@@ -1,5 +1,5 @@
|
||||
cmake_minimum_required (VERSION 3.0)
|
||||
project (nncmpp VERSION 1.2.0 LANGUAGES C)
|
||||
project (nncmpp VERSION 2.0.0 LANGUAGES C)
|
||||
|
||||
# Moar warnings
|
||||
if ("${CMAKE_C_COMPILER_ID}" MATCHES "GNU" OR CMAKE_COMPILER_IS_GNUCC)
|
||||
@@ -58,11 +58,20 @@ if (WITH_PULSE)
|
||||
list (APPEND extra_libraries ${libpulse_LIBRARIES})
|
||||
endif ()
|
||||
|
||||
pkg_check_modules (x11 x11 xrender xft fontconfig)
|
||||
option (WITH_X11 "Use FFTW to enable spectrum visualisation" ${x11_FOUND})
|
||||
if (WITH_X11)
|
||||
if (NOT x11_FOUND)
|
||||
message (FATAL_ERROR "Some X11 libraries were not found")
|
||||
endif ()
|
||||
list (APPEND extra_libraries ${x11_LIBRARIES})
|
||||
endif ()
|
||||
|
||||
include_directories (${Unistring_INCLUDE_DIRS}
|
||||
${Ncursesw_INCLUDE_DIRS} ${Termo_INCLUDE_DIRS} ${curl_INCLUDE_DIRS}
|
||||
${fftw_INCLUDE_DIRS} ${libpulse_INCLUDE_DIRS})
|
||||
${fftw_INCLUDE_DIRS} ${libpulse_INCLUDE_DIRS} ${x11_INCLUDE_DIRS})
|
||||
link_directories (${curl_LIBRARY_DIRS}
|
||||
${fftw_LIBRARY_DIRS} ${libpulse_LIBRARY_DIRS})
|
||||
${fftw_LIBRARY_DIRS} ${libpulse_LIBRARY_DIRS} ${x11_LIBRARY_DIRS})
|
||||
|
||||
# Configuration
|
||||
if ("${CMAKE_SYSTEM_NAME}" MATCHES "BSD")
|
||||
@@ -119,20 +128,31 @@ install (DIRECTORY contrib DESTINATION ${CMAKE_INSTALL_DATADIR}/${PROJECT_NAME})
|
||||
|
||||
# Generate documentation from text markup
|
||||
find_program (ASCIIDOCTOR_EXECUTABLE asciidoctor)
|
||||
if (NOT ASCIIDOCTOR_EXECUTABLE)
|
||||
message (FATAL_ERROR "asciidoctor not found")
|
||||
find_program (A2X_EXECUTABLE a2x)
|
||||
if (NOT ASCIIDOCTOR_EXECUTABLE AND NOT A2X_EXECUTABLE)
|
||||
message (FATAL_ERROR "Neither asciidoctor nor a2x were found")
|
||||
endif ()
|
||||
|
||||
foreach (page ${PROJECT_NAME})
|
||||
set (page_output "${PROJECT_BINARY_DIR}/${page}.1")
|
||||
list (APPEND project_MAN_PAGES "${page_output}")
|
||||
add_custom_command (OUTPUT ${page_output}
|
||||
COMMAND ${ASCIIDOCTOR_EXECUTABLE} -b manpage
|
||||
-a release-version=${PROJECT_VERSION}
|
||||
"${PROJECT_SOURCE_DIR}/${page}.adoc"
|
||||
-o "${page_output}"
|
||||
DEPENDS ${page}.adoc
|
||||
COMMENT "Generating man page for ${page}" VERBATIM)
|
||||
if (ASCIIDOCTOR_EXECUTABLE)
|
||||
add_custom_command (OUTPUT ${page_output}
|
||||
COMMAND ${ASCIIDOCTOR_EXECUTABLE} -b manpage
|
||||
-a release-version=${PROJECT_VERSION}
|
||||
-o "${page_output}"
|
||||
"${PROJECT_SOURCE_DIR}/${page}.adoc"
|
||||
DEPENDS ${page}.adoc
|
||||
COMMENT "Generating man page for ${page}" VERBATIM)
|
||||
elseif (A2X_EXECUTABLE)
|
||||
add_custom_command (OUTPUT ${page_output}
|
||||
COMMAND ${A2X_EXECUTABLE} --doctype manpage --format manpage
|
||||
-a release-version=${PROJECT_VERSION}
|
||||
-D "${PROJECT_BINARY_DIR}"
|
||||
"${PROJECT_SOURCE_DIR}/${page}.adoc"
|
||||
DEPENDS ${page}.adoc
|
||||
COMMENT "Generating man page for ${page}" VERBATIM)
|
||||
endif ()
|
||||
endforeach ()
|
||||
|
||||
add_custom_target (docs ALL DEPENDS ${project_MAN_PAGES})
|
||||
@@ -144,7 +164,7 @@ foreach (page ${project_MAN_PAGES})
|
||||
endforeach ()
|
||||
|
||||
# CPack
|
||||
set (CPACK_PACKAGE_DESCRIPTION_SUMMARY "MPD client")
|
||||
set (CPACK_PACKAGE_DESCRIPTION_SUMMARY "Terminal/X11 MPD client")
|
||||
set (CPACK_PACKAGE_VENDOR "Premysl Eric Janouch")
|
||||
set (CPACK_PACKAGE_CONTACT "Přemysl Eric Janouch <p@janouch.name>")
|
||||
set (CPACK_RESOURCE_FILE_LICENSE "${PROJECT_SOURCE_DIR}/LICENSE")
|
||||
|
||||
2
LICENSE
2
LICENSE
@@ -1,4 +1,4 @@
|
||||
Copyright (c) 2016 - 2021, Přemysl Eric Janouch <p@janouch.name>
|
||||
Copyright (c) 2016 - 2022, Přemysl Eric Janouch <p@janouch.name>
|
||||
|
||||
Permission to use, copy, modify, and/or distribute this software for any
|
||||
purpose with or without fee is hereby granted.
|
||||
|
||||
19
NEWS
19
NEWS
@@ -1,3 +1,22 @@
|
||||
2.0.0 (2022-09-03)
|
||||
|
||||
* Added an optional X11 user interface
|
||||
|
||||
* Implemented mouse drags on the elapsed time gauge and the scrollbar
|
||||
|
||||
* Added Tab and S-Tab bindings to iterate tabs
|
||||
|
||||
* Added a "z" binding to center the view on the selected item
|
||||
|
||||
* Added a "?" binding to describe items in various tabs
|
||||
|
||||
* Made it possible to adjust the spectrum analyzer's FPS limit
|
||||
|
||||
* Moved "Disconnected" and "Connecting..." messages to the status bar
|
||||
|
||||
* Fixed possibility of connection timeouts with PulseAudio integration
|
||||
|
||||
|
||||
1.2.0 (2021-12-21)
|
||||
|
||||
* Added ability to control the volume of MPD's current PulseAudio sink
|
||||
|
||||
44
README.adoc
44
README.adoc
@@ -1,24 +1,27 @@
|
||||
nncmpp
|
||||
======
|
||||
|
||||
'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.
|
||||
'nncmpp' is yet another MPD client. Its specialty is running equally well in
|
||||
the terminal, or as an X11 client--it will provide the same keyboard- and
|
||||
mouse-friendly interface.
|
||||
|
||||
This project began its life as 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 to make
|
||||
the first TUI client that doesn't feel awkward to use.
|
||||
|
||||
If it's not obvious enough, the name is a pun on all those ridiculous client
|
||||
names, and should be pronounced as "nincompoop".
|
||||
|
||||
Features
|
||||
--------
|
||||
Most stuff is there. Enough for me to use the program exclusively. Among other
|
||||
things, it can display and change PulseAudio volume directly to cover the use
|
||||
case of remote control, it has a fast spectrum visualiser, and both
|
||||
the appearance and key bindings can be customized.
|
||||
Most stuff is there. I've been using the program exclusively for many years.
|
||||
Among other things, it can display and change PulseAudio volume directly
|
||||
to cover the use case of remote control, it has a fast spectrum visualiser,
|
||||
and both its appearance and key bindings can be customized.
|
||||
|
||||
Note that since I only use the filesystem browsing mode, that's also the only
|
||||
thing I care to implement for the time being. Similarly, the search feature is
|
||||
known to be clumsy.
|
||||
Note that currently only the filesystem browsing mode is implemented,
|
||||
and the search feature is known to be clumsy.
|
||||
|
||||
image::nncmpp.png[align="center"]
|
||||
|
||||
@@ -34,10 +37,10 @@ The rest of this README will concern itself with externalities.
|
||||
|
||||
Building
|
||||
--------
|
||||
Build dependencies: CMake, pkg-config, asciidoctor,
|
||||
Build dependencies: CMake, pkg-config, asciidoctor or asciidoc,
|
||||
liberty (included), termo (included) +
|
||||
Runtime dependencies: ncursesw, libunistring, cURL,
|
||||
fftw3 (optional), libpulse (optional)
|
||||
Runtime dependencies: ncursesw, libunistring, cURL +
|
||||
Optional runtime dependencies: fftw3, libpulse, x11, xft
|
||||
|
||||
$ git clone --recursive https://git.janouch.name/p/nncmpp.git
|
||||
$ mkdir nncmpp/build
|
||||
@@ -54,16 +57,19 @@ Or you can try telling CMake to make a package for you. For Debian it is:
|
||||
$ cpack -G DEB
|
||||
# dpkg -i nncmpp-*.deb
|
||||
|
||||
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:
|
||||
User interface caveats
|
||||
----------------------
|
||||
The ncurses interface aspires to be as close to a GUI as possible. Don't shy
|
||||
away from using your mouse (though keyboard is also fine). Terminals are,
|
||||
however, 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
|
||||
|
||||
The X11 graphical interface is a second-class citizen, so some limitations of
|
||||
terminals carry over, such as the plain default theme.
|
||||
|
||||
Contributing and Support
|
||||
------------------------
|
||||
Use https://git.janouch.name/p/nncmpp to report any bugs, request features,
|
||||
|
||||
@@ -7,5 +7,6 @@
|
||||
#cmakedefine HAVE_RESIZETERM
|
||||
#cmakedefine WITH_FFTW
|
||||
#cmakedefine WITH_PULSE
|
||||
#cmakedefine WITH_X11
|
||||
|
||||
#endif /* ! CONFIG_H */
|
||||
|
||||
2
liberty
2
liberty
Submodule liberty updated: 7e8e085c97...63aed8f0fd
@@ -36,12 +36,14 @@ PULSE_MUTE, Toggle PulseAudio sink mute
|
||||
|
||||
CHOOSE, Choose item
|
||||
DELETE, Delete item
|
||||
DESCRIBE, Describe item
|
||||
UP, Go up a level
|
||||
MULTISELECT, Toggle multiselect
|
||||
INCREMENTAL_SEARCH, Incremental search
|
||||
|
||||
SCROLL_UP, Scroll up
|
||||
SCROLL_DOWN, Scroll down
|
||||
CENTER_CURSOR, Center the cursor
|
||||
MOVE_UP, Move selection up
|
||||
MOVE_DOWN, Move selection down
|
||||
|
||||
|
||||
15
nncmpp.adoc
15
nncmpp.adoc
@@ -6,7 +6,7 @@ nncmpp(1)
|
||||
|
||||
Name
|
||||
----
|
||||
nncmpp - terminal-based MPD client
|
||||
nncmpp - MPD client
|
||||
|
||||
Synopsis
|
||||
--------
|
||||
@@ -14,7 +14,7 @@ Synopsis
|
||||
|
||||
Description
|
||||
-----------
|
||||
*nncmpp* is a terminal-based GUI-like MPD client. On start up it will welcome
|
||||
*nncmpp* is a hybrid terminal/X11 MPD client. On start up it will welcome
|
||||
you with an overview of all key bindings and the actions they're assigned to.
|
||||
Individual tabs can be switched to either using the mouse or by pressing *M-1*
|
||||
through *M-9*, corresponding to the order they appear in.
|
||||
@@ -29,6 +29,10 @@ Options
|
||||
Adds a "Debug" tab showing all MPD communication and other information
|
||||
that help debug various issues.
|
||||
|
||||
*-x*, *--x11*::
|
||||
Use an X11 interface even when run from a terminal.
|
||||
Note that the application may be built with this feature disabled.
|
||||
|
||||
*-h*, *--help*::
|
||||
Display a help message and exit.
|
||||
|
||||
@@ -48,6 +52,7 @@ settings = {
|
||||
address = "~/.mpd/mpd.socket"
|
||||
password = "<your password>"
|
||||
pulseaudio = on
|
||||
x11_font = "sans\\-serif-11"
|
||||
}
|
||||
colors = {
|
||||
normal = ""
|
||||
@@ -69,9 +74,9 @@ streams = {
|
||||
}
|
||||
....
|
||||
|
||||
Terminal attributes are accepted in a format similar to that of *git-config*(1),
|
||||
only named colours aren't supported. The distribution contains example colour
|
||||
schemes in the _contrib_ directory.
|
||||
Terminal attributes also apply to the GUI, and are accepted in a format similar
|
||||
to that of *git-config*(1), only named colours aren't supported.
|
||||
The distribution contains example colour schemes in the _contrib_ directory.
|
||||
|
||||
// TODO: it seems like liberty should contain an includable snippet about
|
||||
// the format, which could form a part of nncmpp.conf(5).
|
||||
|
||||
BIN
nncmpp.png
BIN
nncmpp.png
Binary file not shown.
|
Before Width: | Height: | Size: 4.6 KiB After Width: | Height: | Size: 35 KiB |
Reference in New Issue
Block a user