Compare commits
40 Commits
5aa07fd8af
...
v2.0.0
| 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
|
|||
|
61a141203b
|
|||
|
48482ef2e5
|
|||
|
840c69767c
|
|||
|
a14a907b18
|
|||
|
333049de01
|
|||
|
4e3596db35
|
@@ -1,5 +1,5 @@
|
|||||||
cmake_minimum_required (VERSION 3.0)
|
cmake_minimum_required (VERSION 3.0)
|
||||||
project (nncmpp VERSION 1.1.1 LANGUAGES C)
|
project (nncmpp VERSION 2.0.0 LANGUAGES C)
|
||||||
|
|
||||||
# Moar warnings
|
# Moar warnings
|
||||||
if ("${CMAKE_C_COMPILER_ID}" MATCHES "GNU" OR CMAKE_COMPILER_IS_GNUCC)
|
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})
|
list (APPEND extra_libraries ${libpulse_LIBRARIES})
|
||||||
endif ()
|
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}
|
include_directories (${Unistring_INCLUDE_DIRS}
|
||||||
${Ncursesw_INCLUDE_DIRS} ${Termo_INCLUDE_DIRS} ${curl_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}
|
link_directories (${curl_LIBRARY_DIRS}
|
||||||
${fftw_LIBRARY_DIRS} ${libpulse_LIBRARY_DIRS})
|
${fftw_LIBRARY_DIRS} ${libpulse_LIBRARY_DIRS} ${x11_LIBRARY_DIRS})
|
||||||
|
|
||||||
# Configuration
|
# Configuration
|
||||||
if ("${CMAKE_SYSTEM_NAME}" MATCHES "BSD")
|
if ("${CMAKE_SYSTEM_NAME}" MATCHES "BSD")
|
||||||
@@ -119,20 +128,31 @@ install (DIRECTORY contrib DESTINATION ${CMAKE_INSTALL_DATADIR}/${PROJECT_NAME})
|
|||||||
|
|
||||||
# Generate documentation from text markup
|
# Generate documentation from text markup
|
||||||
find_program (ASCIIDOCTOR_EXECUTABLE asciidoctor)
|
find_program (ASCIIDOCTOR_EXECUTABLE asciidoctor)
|
||||||
if (NOT ASCIIDOCTOR_EXECUTABLE)
|
find_program (A2X_EXECUTABLE a2x)
|
||||||
message (FATAL_ERROR "asciidoctor not found")
|
if (NOT ASCIIDOCTOR_EXECUTABLE AND NOT A2X_EXECUTABLE)
|
||||||
|
message (FATAL_ERROR "Neither asciidoctor nor a2x were found")
|
||||||
endif ()
|
endif ()
|
||||||
|
|
||||||
foreach (page ${PROJECT_NAME})
|
foreach (page ${PROJECT_NAME})
|
||||||
set (page_output "${PROJECT_BINARY_DIR}/${page}.1")
|
set (page_output "${PROJECT_BINARY_DIR}/${page}.1")
|
||||||
list (APPEND project_MAN_PAGES "${page_output}")
|
list (APPEND project_MAN_PAGES "${page_output}")
|
||||||
add_custom_command (OUTPUT ${page_output}
|
if (ASCIIDOCTOR_EXECUTABLE)
|
||||||
COMMAND ${ASCIIDOCTOR_EXECUTABLE} -b manpage
|
add_custom_command (OUTPUT ${page_output}
|
||||||
-a release-version=${PROJECT_VERSION}
|
COMMAND ${ASCIIDOCTOR_EXECUTABLE} -b manpage
|
||||||
"${PROJECT_SOURCE_DIR}/${page}.adoc"
|
-a release-version=${PROJECT_VERSION}
|
||||||
-o "${page_output}"
|
-o "${page_output}"
|
||||||
DEPENDS ${page}.adoc
|
"${PROJECT_SOURCE_DIR}/${page}.adoc"
|
||||||
COMMENT "Generating man page for ${page}" VERBATIM)
|
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 ()
|
endforeach ()
|
||||||
|
|
||||||
add_custom_target (docs ALL DEPENDS ${project_MAN_PAGES})
|
add_custom_target (docs ALL DEPENDS ${project_MAN_PAGES})
|
||||||
@@ -144,7 +164,7 @@ foreach (page ${project_MAN_PAGES})
|
|||||||
endforeach ()
|
endforeach ()
|
||||||
|
|
||||||
# CPack
|
# 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_VENDOR "Premysl Eric Janouch")
|
||||||
set (CPACK_PACKAGE_CONTACT "Přemysl Eric Janouch <p@janouch.name>")
|
set (CPACK_PACKAGE_CONTACT "Přemysl Eric Janouch <p@janouch.name>")
|
||||||
set (CPACK_RESOURCE_FILE_LICENSE "${PROJECT_SOURCE_DIR}/LICENSE")
|
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
|
Permission to use, copy, modify, and/or distribute this software for any
|
||||||
purpose with or without fee is hereby granted.
|
purpose with or without fee is hereby granted.
|
||||||
|
|||||||
30
NEWS
30
NEWS
@@ -1,3 +1,33 @@
|
|||||||
|
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
|
||||||
|
|
||||||
|
* Now fetching Internet stream information asynchronously
|
||||||
|
|
||||||
|
* Added basic incremental search, normally bound to C-s, in all tabs
|
||||||
|
|
||||||
|
* Fixed jumping to the beginning of the queue after deleting items
|
||||||
|
|
||||||
|
|
||||||
1.1.1 (2021-11-04)
|
1.1.1 (2021-11-04)
|
||||||
|
|
||||||
* Terminal focus in/out events no longer ring the terminall bell
|
* Terminal focus in/out events no longer ring the terminall bell
|
||||||
|
|||||||
44
README.adoc
44
README.adoc
@@ -1,24 +1,27 @@
|
|||||||
nncmpp
|
nncmpp
|
||||||
======
|
======
|
||||||
|
|
||||||
'nncmpp' is yet another MPD client. It is in effect a simplified TUI version
|
'nncmpp' is yet another MPD client. Its specialty is running equally well in
|
||||||
of Sonata. I had already written a lot of the required code before, so I had
|
the terminal, or as an X11 client--it will provide the same keyboard- and
|
||||||
the perfect opportunity to get rid of the unmaintained Python application and
|
mouse-friendly interface.
|
||||||
make the first TUI client that doesn't feel awkward to use.
|
|
||||||
|
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
|
If it's not obvious enough, the name is a pun on all those ridiculous client
|
||||||
names, and should be pronounced as "nincompoop".
|
names, and should be pronounced as "nincompoop".
|
||||||
|
|
||||||
Features
|
Features
|
||||||
--------
|
--------
|
||||||
Most stuff is there. Enough for me to use the program exclusively. Among other
|
Most stuff is there. I've been using the program exclusively for many years.
|
||||||
things, it can display and change PulseAudio volume directly to cover the use
|
Among other things, it can display and change PulseAudio volume directly
|
||||||
case of remote control, it has a fast spectrum visualiser, and both
|
to cover the use case of remote control, it has a fast spectrum visualiser,
|
||||||
the appearance and key bindings can be customized.
|
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
|
Note that currently only the filesystem browsing mode is implemented,
|
||||||
thing I care to implement for the time being. Similarly, the search feature is
|
and the search feature is known to be clumsy.
|
||||||
known to be clumsy.
|
|
||||||
|
|
||||||
image::nncmpp.png[align="center"]
|
image::nncmpp.png[align="center"]
|
||||||
|
|
||||||
@@ -34,10 +37,10 @@ The rest of this README will concern itself with externalities.
|
|||||||
|
|
||||||
Building
|
Building
|
||||||
--------
|
--------
|
||||||
Build dependencies: CMake, pkg-config, asciidoctor,
|
Build dependencies: CMake, pkg-config, asciidoctor or asciidoc,
|
||||||
liberty (included), termo (included) +
|
liberty (included), termo (included) +
|
||||||
Runtime dependencies: ncursesw, libunistring, cURL,
|
Runtime dependencies: ncursesw, libunistring, cURL +
|
||||||
fftw3 (optional), libpulse (optional)
|
Optional runtime dependencies: fftw3, libpulse, x11, xft
|
||||||
|
|
||||||
$ git clone --recursive https://git.janouch.name/p/nncmpp.git
|
$ git clone --recursive https://git.janouch.name/p/nncmpp.git
|
||||||
$ mkdir nncmpp/build
|
$ 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
|
$ cpack -G DEB
|
||||||
# dpkg -i nncmpp-*.deb
|
# dpkg -i nncmpp-*.deb
|
||||||
|
|
||||||
Terminal caveats
|
User interface caveats
|
||||||
----------------
|
----------------------
|
||||||
This application aspires to be as close to a GUI as possible. It expects you
|
The ncurses interface aspires to be as close to a GUI as possible. Don't shy
|
||||||
to use the mouse (though it's not required). Terminals are, however, somewhat
|
away from using your mouse (though keyboard is also fine). Terminals are,
|
||||||
tricky to get consistent results on, so be aware of the following:
|
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
|
- use a UTF-8 locale to get finer resolution progress bars and scrollbars
|
||||||
- Xterm needs `XTerm*metaSendsEscape: true` for the default bindings to work
|
- Xterm needs `XTerm*metaSendsEscape: true` for the default bindings to work
|
||||||
- urxvt's 'vtwheel' plugin sabotages scrolling
|
- 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
|
Contributing and Support
|
||||||
------------------------
|
------------------------
|
||||||
Use https://git.janouch.name/p/nncmpp to report any bugs, request features,
|
Use https://git.janouch.name/p/nncmpp to report any bugs, request features,
|
||||||
|
|||||||
@@ -7,5 +7,6 @@
|
|||||||
#cmakedefine HAVE_RESIZETERM
|
#cmakedefine HAVE_RESIZETERM
|
||||||
#cmakedefine WITH_FFTW
|
#cmakedefine WITH_FFTW
|
||||||
#cmakedefine WITH_PULSE
|
#cmakedefine WITH_PULSE
|
||||||
|
#cmakedefine WITH_X11
|
||||||
|
|
||||||
#endif /* ! CONFIG_H */
|
#endif /* ! CONFIG_H */
|
||||||
|
|||||||
2
liberty
2
liberty
Submodule liberty updated: 782a9a5977...63aed8f0fd
@@ -36,11 +36,14 @@ PULSE_MUTE, Toggle PulseAudio sink mute
|
|||||||
|
|
||||||
CHOOSE, Choose item
|
CHOOSE, Choose item
|
||||||
DELETE, Delete item
|
DELETE, Delete item
|
||||||
|
DESCRIBE, Describe item
|
||||||
UP, Go up a level
|
UP, Go up a level
|
||||||
MULTISELECT, Toggle multiselect
|
MULTISELECT, Toggle multiselect
|
||||||
|
INCREMENTAL_SEARCH, Incremental search
|
||||||
|
|
||||||
SCROLL_UP, Scroll up
|
SCROLL_UP, Scroll up
|
||||||
SCROLL_DOWN, Scroll down
|
SCROLL_DOWN, Scroll down
|
||||||
|
CENTER_CURSOR, Center the cursor
|
||||||
MOVE_UP, Move selection up
|
MOVE_UP, Move selection up
|
||||||
MOVE_DOWN, Move selection down
|
MOVE_DOWN, Move selection down
|
||||||
|
|
||||||
|
|||||||
15
nncmpp.adoc
15
nncmpp.adoc
@@ -6,7 +6,7 @@ nncmpp(1)
|
|||||||
|
|
||||||
Name
|
Name
|
||||||
----
|
----
|
||||||
nncmpp - terminal-based MPD client
|
nncmpp - MPD client
|
||||||
|
|
||||||
Synopsis
|
Synopsis
|
||||||
--------
|
--------
|
||||||
@@ -14,7 +14,7 @@ Synopsis
|
|||||||
|
|
||||||
Description
|
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.
|
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*
|
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.
|
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
|
Adds a "Debug" tab showing all MPD communication and other information
|
||||||
that help debug various issues.
|
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*::
|
*-h*, *--help*::
|
||||||
Display a help message and exit.
|
Display a help message and exit.
|
||||||
|
|
||||||
@@ -48,6 +52,7 @@ settings = {
|
|||||||
address = "~/.mpd/mpd.socket"
|
address = "~/.mpd/mpd.socket"
|
||||||
password = "<your password>"
|
password = "<your password>"
|
||||||
pulseaudio = on
|
pulseaudio = on
|
||||||
|
x11_font = "sans\\-serif-11"
|
||||||
}
|
}
|
||||||
colors = {
|
colors = {
|
||||||
normal = ""
|
normal = ""
|
||||||
@@ -69,9 +74,9 @@ streams = {
|
|||||||
}
|
}
|
||||||
....
|
....
|
||||||
|
|
||||||
Terminal attributes are accepted in a format similar to that of *git-config*(1),
|
Terminal attributes also apply to the GUI, and are accepted in a format similar
|
||||||
only named colours aren't supported. The distribution contains example colour
|
to that of *git-config*(1), only named colours aren't supported.
|
||||||
schemes in the _contrib_ directory.
|
The distribution contains example colour schemes in the _contrib_ directory.
|
||||||
|
|
||||||
// TODO: it seems like liberty should contain an includable snippet about
|
// TODO: it seems like liberty should contain an includable snippet about
|
||||||
// the format, which could form a part of nncmpp.conf(5).
|
// 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