Compare commits
85 Commits
144
CMakeLists.txt
144
CMakeLists.txt
|
@ -1,5 +1,5 @@
|
||||||
cmake_minimum_required (VERSION 3.0)
|
cmake_minimum_required (VERSION 3.0...3.27)
|
||||||
project (nncmpp VERSION 1.2.0 LANGUAGES C)
|
project (nncmpp VERSION 2.1.1 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)
|
||||||
|
@ -10,6 +10,14 @@ endif ()
|
||||||
# For custom modules
|
# For custom modules
|
||||||
set (CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/liberty/cmake)
|
set (CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/liberty/cmake)
|
||||||
|
|
||||||
|
# Collect important build toggles for our simple preprocessor
|
||||||
|
# (cpp(1) isn't part of POSIX, otherwise we could reuse config.h)
|
||||||
|
set (options)
|
||||||
|
macro (add_option variable help value)
|
||||||
|
option (${ARGV})
|
||||||
|
list (APPEND options "${variable}=$<BOOL:${${variable}}>")
|
||||||
|
endmacro ()
|
||||||
|
|
||||||
# Dependencies
|
# Dependencies
|
||||||
find_package (Ncursesw REQUIRED)
|
find_package (Ncursesw REQUIRED)
|
||||||
find_package (PkgConfig REQUIRED)
|
find_package (PkgConfig REQUIRED)
|
||||||
|
@ -19,8 +27,8 @@ pkg_check_modules (curl REQUIRED libcurl)
|
||||||
include (AddThreads)
|
include (AddThreads)
|
||||||
|
|
||||||
find_package (Termo QUIET NO_MODULE)
|
find_package (Termo QUIET NO_MODULE)
|
||||||
option (USE_SYSTEM_TERMO
|
add_option (USE_SYSTEM_TERMO
|
||||||
"Don't compile our own termo library, use the system one" ${Termo_FOUND})
|
"Don't compile our own termo library, use the system one" "${Termo_FOUND}")
|
||||||
if (USE_SYSTEM_TERMO)
|
if (USE_SYSTEM_TERMO)
|
||||||
if (NOT Termo_FOUND)
|
if (NOT Termo_FOUND)
|
||||||
message (FATAL_ERROR "System termo library not found")
|
message (FATAL_ERROR "System termo library not found")
|
||||||
|
@ -41,7 +49,8 @@ else ()
|
||||||
endif ()
|
endif ()
|
||||||
|
|
||||||
pkg_check_modules (fftw fftw3 fftw3f)
|
pkg_check_modules (fftw fftw3 fftw3f)
|
||||||
option (WITH_FFTW "Use FFTW to enable spectrum visualisation" ${fftw_FOUND})
|
add_option (WITH_FFTW
|
||||||
|
"Use FFTW to enable spectrum visualisation" "${fftw_FOUND}")
|
||||||
if (WITH_FFTW)
|
if (WITH_FFTW)
|
||||||
if (NOT fftw_FOUND)
|
if (NOT fftw_FOUND)
|
||||||
message (FATAL_ERROR "FFTW not found")
|
message (FATAL_ERROR "FFTW not found")
|
||||||
|
@ -50,7 +59,8 @@ if (WITH_FFTW)
|
||||||
endif ()
|
endif ()
|
||||||
|
|
||||||
pkg_check_modules (libpulse libpulse)
|
pkg_check_modules (libpulse libpulse)
|
||||||
option (WITH_PULSE "Enable control of PulseAudio sink volume" ${libpulse_FOUND})
|
add_option (WITH_PULSE
|
||||||
|
"Enable PulseAudio sink volume control" "${libpulse_FOUND}")
|
||||||
if (WITH_PULSE)
|
if (WITH_PULSE)
|
||||||
if (NOT libpulse_FOUND)
|
if (NOT libpulse_FOUND)
|
||||||
message (FATAL_ERROR "libpulse not found")
|
message (FATAL_ERROR "libpulse not found")
|
||||||
|
@ -58,11 +68,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 libpng)
|
||||||
|
add_option (WITH_X11 "Build with X11 support" "${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")
|
||||||
|
@ -86,53 +105,89 @@ foreach (extra m)
|
||||||
endforeach ()
|
endforeach ()
|
||||||
|
|
||||||
# Generate a configuration file
|
# Generate a configuration file
|
||||||
|
include (GNUInstallDirs)
|
||||||
configure_file (${PROJECT_SOURCE_DIR}/config.h.in
|
configure_file (${PROJECT_SOURCE_DIR}/config.h.in
|
||||||
${PROJECT_BINARY_DIR}/config.h)
|
${PROJECT_BINARY_DIR}/config.h)
|
||||||
include_directories (${PROJECT_SOURCE_DIR} ${PROJECT_BINARY_DIR})
|
include_directories (${PROJECT_SOURCE_DIR} ${PROJECT_BINARY_DIR})
|
||||||
|
|
||||||
# Assuming a Unix-compatible system with a standalone preprocessor
|
|
||||||
set (actions_list ${PROJECT_SOURCE_DIR}/nncmpp.actions)
|
set (actions_list ${PROJECT_SOURCE_DIR}/nncmpp.actions)
|
||||||
|
set (actions_awk ${PROJECT_SOURCE_DIR}/nncmpp.actions.awk)
|
||||||
set (actions ${PROJECT_BINARY_DIR}/nncmpp-actions.h)
|
set (actions ${PROJECT_BINARY_DIR}/nncmpp-actions.h)
|
||||||
add_custom_command (OUTPUT ${actions}
|
add_custom_command (OUTPUT ${actions}
|
||||||
COMMAND cpp -I${PROJECT_BINARY_DIR} -P ${actions_list}
|
COMMAND env LC_ALL=C ${options}
|
||||||
| grep . | tr [[\n]] ^ | sed -ne [[h; s/,[^^]*/,/g]] -e [[s/$/COUNT/]]
|
awk -f ${actions_awk} ${actions_list} > ${actions}
|
||||||
-e [[s/[^^]*/\tACTION_&/g]] -e [[s/.*/enum action {\n&\n};\n/p]]
|
DEPENDS ${actions_awk} ${actions_list} VERBATIM)
|
||||||
-e [[g; s/,[^^]*//g; y/_/-/]] -e [[s/[^^]\{1,\}/\t"&",/g]]
|
|
||||||
-e [[s/.*/static const char *g_action_names[] = {\n&};\n/p]]
|
|
||||||
-e [[g; s/[^^]*, *//g;]] -e [[s/[^^]\{1,\}/\t"&",/g]]
|
|
||||||
-e [[s/.*/static const char *g_action_descriptions[] = {\n&};/p]]
|
|
||||||
| tr ^ [[\n]] > ${actions}
|
|
||||||
COMMAND test -s ${actions}
|
|
||||||
DEPENDS ${actions_list} ${PROJECT_BINARY_DIR}/config.h VERBATIM)
|
|
||||||
|
|
||||||
# Build the main executable and link it
|
# Build the main executable and link it
|
||||||
add_executable (${PROJECT_NAME} ${PROJECT_NAME}.c ${actions})
|
add_executable (${PROJECT_NAME} ${PROJECT_NAME}.c ${actions})
|
||||||
target_link_libraries (${PROJECT_NAME} ${Unistring_LIBRARIES}
|
target_link_libraries (${PROJECT_NAME} ${Unistring_LIBRARIES}
|
||||||
${Ncursesw_LIBRARIES} termo-static ${curl_LIBRARIES} ${extra_libraries})
|
${Ncursesw_LIBRARIES} ${Termo_LIBRARIES} ${curl_LIBRARIES}
|
||||||
|
${extra_libraries})
|
||||||
add_threads (${PROJECT_NAME})
|
add_threads (${PROJECT_NAME})
|
||||||
|
|
||||||
# Installation
|
# Installation
|
||||||
include (GNUInstallDirs)
|
|
||||||
install (TARGETS ${PROJECT_NAME} DESTINATION ${CMAKE_INSTALL_BINDIR})
|
install (TARGETS ${PROJECT_NAME} DESTINATION ${CMAKE_INSTALL_BINDIR})
|
||||||
install (FILES LICENSE DESTINATION ${CMAKE_INSTALL_DOCDIR})
|
install (FILES LICENSE DESTINATION ${CMAKE_INSTALL_DOCDIR})
|
||||||
install (DIRECTORY contrib DESTINATION ${CMAKE_INSTALL_DATADIR}/${PROJECT_NAME})
|
install (DIRECTORY contrib DESTINATION ${CMAKE_INSTALL_DATADIR}/${PROJECT_NAME})
|
||||||
|
install (DIRECTORY info DESTINATION ${CMAKE_INSTALL_DATADIR}/${PROJECT_NAME}
|
||||||
|
USE_SOURCE_PERMISSIONS)
|
||||||
|
if (WITH_X11)
|
||||||
|
include (IconUtils)
|
||||||
|
|
||||||
|
set (icon_base ${PROJECT_BINARY_DIR}/icons)
|
||||||
|
set (icon_png_list)
|
||||||
|
foreach (icon_size 16 32 48)
|
||||||
|
icon_to_png (${PROJECT_NAME} ${PROJECT_SOURCE_DIR}/${PROJECT_NAME}.svg
|
||||||
|
${icon_size} ${icon_base} icon_png)
|
||||||
|
list (APPEND icon_png_list ${icon_png})
|
||||||
|
endforeach ()
|
||||||
|
|
||||||
|
add_custom_target (icons ALL DEPENDS ${icon_png_list})
|
||||||
|
|
||||||
|
install (FILES ${PROJECT_NAME}.svg
|
||||||
|
DESTINATION ${CMAKE_INSTALL_DATADIR}/icons/hicolor/scalable/apps)
|
||||||
|
install (DIRECTORY ${icon_base}
|
||||||
|
DESTINATION ${CMAKE_INSTALL_DATADIR})
|
||||||
|
install (FILES ${PROJECT_NAME}.desktop
|
||||||
|
DESTINATION ${CMAKE_INSTALL_DATADIR}/applications)
|
||||||
|
endif ()
|
||||||
|
|
||||||
# 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 (WARNING "Neither asciidoctor nor a2x were found, "
|
||||||
|
"falling back to a substandard manual page generator")
|
||||||
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)
|
||||||
|
else ()
|
||||||
|
set (ASCIIMAN ${PROJECT_SOURCE_DIR}/liberty/tools/asciiman.awk)
|
||||||
|
add_custom_command (OUTPUT ${page_output}
|
||||||
|
COMMAND env LC_ALL=C asciidoc-release-version=${PROJECT_VERSION}
|
||||||
|
awk -f ${ASCIIMAN} "${PROJECT_SOURCE_DIR}/${page}.adoc"
|
||||||
|
> ${page_output}
|
||||||
|
DEPENDS ${page}.adoc ${ASCIIMAN}
|
||||||
|
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})
|
||||||
|
@ -143,8 +198,35 @@ foreach (page ${project_MAN_PAGES})
|
||||||
DESTINATION "${CMAKE_INSTALL_MANDIR}/man${CMAKE_MATCH_1}")
|
DESTINATION "${CMAKE_INSTALL_MANDIR}/man${CMAKE_MATCH_1}")
|
||||||
endforeach ()
|
endforeach ()
|
||||||
|
|
||||||
|
# Testing
|
||||||
|
option (BUILD_TESTING "Build tests" OFF)
|
||||||
|
if (BUILD_TESTING)
|
||||||
|
enable_testing ()
|
||||||
|
|
||||||
|
find_program (xmlwf_EXECUTABLE xmlwf)
|
||||||
|
find_program (xmllint_EXECUTABLE xmllint)
|
||||||
|
foreach (xml ${PROJECT_NAME}.svg)
|
||||||
|
if (xmlwf_EXECUTABLE)
|
||||||
|
add_test (test-xmlwf-${xml} ${xmlwf_EXECUTABLE}
|
||||||
|
${PROJECT_SOURCE_DIR}/${xml})
|
||||||
|
endif ()
|
||||||
|
if (xmllint_EXECUTABLE)
|
||||||
|
add_test (test-xmllint-${xml} ${xmllint_EXECUTABLE} --noout
|
||||||
|
${PROJECT_SOURCE_DIR}/${xml})
|
||||||
|
endif ()
|
||||||
|
endforeach ()
|
||||||
|
|
||||||
|
find_program (dfv_EXECUTABLE desktop-file-validate)
|
||||||
|
if (dfv_EXECUTABLE)
|
||||||
|
foreach (df ${PROJECT_NAME}.desktop)
|
||||||
|
add_test (test-dfv-${df} ${dfv_EXECUTABLE}
|
||||||
|
${PROJECT_SOURCE_DIR}/${df})
|
||||||
|
endforeach ()
|
||||||
|
endif ()
|
||||||
|
endif ()
|
||||||
|
|
||||||
# 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 - 2023, 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.
|
||||||
|
|
56
NEWS
56
NEWS
|
@ -1,3 +1,59 @@
|
||||||
|
2.1.1 (2024-02-27)
|
||||||
|
|
||||||
|
* Fixed installation of Info tab plugins
|
||||||
|
|
||||||
|
* Fixed display of playback mode toggles in the terminal user interface
|
||||||
|
|
||||||
|
* Fixed a dead link in the manual page
|
||||||
|
|
||||||
|
|
||||||
|
2.1.0 (2024-02-11)
|
||||||
|
|
||||||
|
* Added ability to look up song lyrics,
|
||||||
|
using a new scriptable extension interface for the Info tab
|
||||||
|
|
||||||
|
* Improved song information shown in the window header
|
||||||
|
|
||||||
|
* Escape no longer quits the program
|
||||||
|
|
||||||
|
* X11: added an icon and a desktop entry file
|
||||||
|
|
||||||
|
* X11: added support for font fallbacks and italic fonts
|
||||||
|
|
||||||
|
* X11: fixed rendering of overflowing, partially visible list items
|
||||||
|
|
||||||
|
* X11: fixed a crash when resizing the window to zero dimensions
|
||||||
|
|
||||||
|
* Added a "o" binding to select the currently playing song
|
||||||
|
|
||||||
|
* Added Readline-like M-u, M-l, M-c editor bindings
|
||||||
|
|
||||||
|
* Made the scroll wheel work on the elapsed time gauge and the volume display
|
||||||
|
|
||||||
|
* Changed volume adjustment bindings to use +/- keys
|
||||||
|
|
||||||
|
* Changed volume adjustment to go in steps of 5 rather than 10 %
|
||||||
|
|
||||||
|
|
||||||
|
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)
|
1.2.0 (2021-12-21)
|
||||||
|
|
||||||
* Added ability to control the volume of MPD's current PulseAudio sink
|
* Added ability to control the volume of MPD's current PulseAudio sink
|
||||||
|
|
55
README.adoc
55
README.adoc
|
@ -1,31 +1,37 @@
|
||||||
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.
|
it can be extended with plugins to fetch lyrics or other song-related info,
|
||||||
|
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"]
|
||||||
|
|
||||||
Packages
|
Packages
|
||||||
--------
|
--------
|
||||||
Regular releases are sporadic. git master should be stable enough. You can get
|
Regular releases are sporadic. git master should be stable enough.
|
||||||
a package with the latest development version from Archlinux's AUR.
|
You can get a package with the latest development version using Arch Linux's
|
||||||
|
https://aur.archlinux.org/packages/nncmpp-git[AUR],
|
||||||
|
or as a https://git.janouch.name/p/nixexprs[Nix derivation].
|
||||||
|
|
||||||
Documentation
|
Documentation
|
||||||
-------------
|
-------------
|
||||||
|
@ -34,10 +40,12 @@ The rest of this README will concern itself with externalities.
|
||||||
|
|
||||||
Building
|
Building
|
||||||
--------
|
--------
|
||||||
Build dependencies: CMake, pkg-config, asciidoctor,
|
Build-only dependencies: CMake, pkg-config, awk, liberty (included),
|
||||||
liberty (included), termo (included) +
|
termo (included), asciidoctor or asciidoc (recommended but optional),
|
||||||
Runtime dependencies: ncursesw, libunistring, cURL,
|
rsvg-convert (X11) +
|
||||||
fftw3 (optional), libpulse (optional)
|
Runtime dependencies: ncursesw, libunistring, cURL +
|
||||||
|
Optional runtime dependencies: fftw3, libpulse, x11 + xft + libpng (X11),
|
||||||
|
Perl + cURL (lyrics)
|
||||||
|
|
||||||
$ 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 +62,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,
|
||||||
|
|
|
@ -4,8 +4,12 @@
|
||||||
#define PROGRAM_NAME "${PROJECT_NAME}"
|
#define PROGRAM_NAME "${PROJECT_NAME}"
|
||||||
#define PROGRAM_VERSION "${PROJECT_VERSION}"
|
#define PROGRAM_VERSION "${PROJECT_VERSION}"
|
||||||
|
|
||||||
|
// We use the XDG Base Directory Specification, but may be installed anywhere.
|
||||||
|
#define PROJECT_DATADIR "${CMAKE_INSTALL_FULL_DATADIR}"
|
||||||
|
|
||||||
#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 */
|
||||||
|
|
|
@ -0,0 +1,43 @@
|
||||||
|
#!/usr/bin/env perl
|
||||||
|
# 10-azlyrics.pl: nncmpp info plugin to fetch song lyrics on AZLyrics
|
||||||
|
#
|
||||||
|
# Copyright (c) 2022, Přemysl Eric Janouch <p@janouch.name>
|
||||||
|
# SPDX-License-Identifier: 0BSD
|
||||||
|
#
|
||||||
|
# Inspired by a similar ncmpc plugin.
|
||||||
|
|
||||||
|
use warnings;
|
||||||
|
use strict;
|
||||||
|
use utf8;
|
||||||
|
use open ':std', ':utf8';
|
||||||
|
unless (@ARGV) {
|
||||||
|
print "Look up on AZLyrics\n";
|
||||||
|
exit;
|
||||||
|
}
|
||||||
|
|
||||||
|
use Encode;
|
||||||
|
my ($title, $artist, $album) = map {decode_utf8($_)} @ARGV;
|
||||||
|
|
||||||
|
# TODO: An upgrade would be transliteration with, e.g., Text::Unidecode.
|
||||||
|
use Unicode::Normalize;
|
||||||
|
$artist = lc(NFD($artist)) =~ s/^the\s+//ir =~ s/[^a-z0-9]//gr;
|
||||||
|
$title = lc(NFD($title)) =~ s/\(.*?\)//gr =~ s/[^a-z0-9]//gr;
|
||||||
|
|
||||||
|
# TODO: Consider caching the results in a location like
|
||||||
|
# $XDG_CACHE_HOME/nncmpp/info/azlyrics/$artist-$title
|
||||||
|
my $found = 0;
|
||||||
|
if ($title ne '') {
|
||||||
|
open(my $curl, '-|', 'curl', '-sA', 'nncmpp/2.0',
|
||||||
|
"https://www.azlyrics.com/lyrics/$artist/$title.html") or die $!;
|
||||||
|
while (<$curl>) {
|
||||||
|
next unless /^<div>/ .. /^<\/div>/; s/<!--.*?-->//g; s/\s+$//gs;
|
||||||
|
|
||||||
|
$found = 1;
|
||||||
|
s/<\/?b>/\x01/g; s/<\/?i>/\x02/g; s/<br>/\n/; s/<.+?>//g;
|
||||||
|
s/</</g; s/>/>/g; s/"/"/g; s/'/'/g; s/&/&/g;
|
||||||
|
print;
|
||||||
|
}
|
||||||
|
close($curl) or die $?;
|
||||||
|
}
|
||||||
|
|
||||||
|
print "No lyrics have been found.\n" unless $found;
|
2
liberty
2
liberty
|
@ -1 +1 @@
|
||||||
Subproject commit 7e8e085c97311b52db4d6739b6ef2a1b26a2319f
|
Subproject commit 969a4cfc3ea1c4d7c0327907385fc64906ed5d4c
|
288
line-editor.c
288
line-editor.c
|
@ -1,288 +0,0 @@
|
||||||
/*
|
|
||||||
* line-editor.c: a line editor component for the TUI part of liberty
|
|
||||||
*
|
|
||||||
* Copyright (c) 2017 - 2018, 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.
|
|
||||||
*
|
|
||||||
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
||||||
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
||||||
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
|
||||||
* SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
||||||
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
|
|
||||||
* OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
|
|
||||||
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
|
|
||||||
// This is here just for IDE code model reasons
|
|
||||||
#ifndef HAVE_LIBERTY
|
|
||||||
#include "liberty/liberty.c"
|
|
||||||
#include "liberty/liberty-tui.c"
|
|
||||||
#endif
|
|
||||||
|
|
||||||
static void
|
|
||||||
row_buffer_append_c (struct row_buffer *self, ucs4_t c, chtype attrs)
|
|
||||||
{
|
|
||||||
struct row_char current = { .attrs = attrs, .c = c };
|
|
||||||
struct row_char invalid = { .attrs = attrs, .c = '?', .width = 1 };
|
|
||||||
|
|
||||||
current.width = uc_width (current.c, locale_charset ());
|
|
||||||
if (current.width < 0 || !app_is_character_in_locale (current.c))
|
|
||||||
current = invalid;
|
|
||||||
|
|
||||||
ARRAY_RESERVE (self->chars, 1);
|
|
||||||
self->chars[self->chars_len++] = current;
|
|
||||||
self->total_width += current.width;
|
|
||||||
}
|
|
||||||
|
|
||||||
// --- Line editor -------------------------------------------------------------
|
|
||||||
|
|
||||||
enum line_editor_action
|
|
||||||
{
|
|
||||||
LINE_EDITOR_B_CHAR, ///< Go back a character
|
|
||||||
LINE_EDITOR_F_CHAR, ///< Go forward a character
|
|
||||||
LINE_EDITOR_B_WORD, ///< Go back a word
|
|
||||||
LINE_EDITOR_F_WORD, ///< Go forward a word
|
|
||||||
LINE_EDITOR_HOME, ///< Go to start of line
|
|
||||||
LINE_EDITOR_END, ///< Go to end of line
|
|
||||||
|
|
||||||
LINE_EDITOR_B_DELETE, ///< Delete last character
|
|
||||||
LINE_EDITOR_F_DELETE, ///< Delete next character
|
|
||||||
LINE_EDITOR_B_KILL_WORD, ///< Delete last word
|
|
||||||
LINE_EDITOR_B_KILL_LINE, ///< Delete everything up to BOL
|
|
||||||
LINE_EDITOR_F_KILL_LINE, ///< Delete everything up to EOL
|
|
||||||
};
|
|
||||||
|
|
||||||
struct line_editor
|
|
||||||
{
|
|
||||||
int point; ///< Caret index into line data
|
|
||||||
ucs4_t *line; ///< Line data, 0-terminated
|
|
||||||
int *w; ///< Codepoint widths, 0-terminated
|
|
||||||
size_t len; ///< Editor length
|
|
||||||
size_t alloc; ///< Editor allocated
|
|
||||||
char prompt; ///< Prompt character
|
|
||||||
|
|
||||||
void (*on_changed) (void); ///< Callback on text change
|
|
||||||
void (*on_end) (bool); ///< Callback on abort
|
|
||||||
};
|
|
||||||
|
|
||||||
static void
|
|
||||||
line_editor_free (struct line_editor *self)
|
|
||||||
{
|
|
||||||
free (self->line);
|
|
||||||
free (self->w);
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Notify whomever invoked the editor that it's been either confirmed or
|
|
||||||
/// cancelled and clean up editor state
|
|
||||||
static void
|
|
||||||
line_editor_abort (struct line_editor *self, bool status)
|
|
||||||
{
|
|
||||||
self->on_end (status);
|
|
||||||
self->on_changed = NULL;
|
|
||||||
|
|
||||||
free (self->line);
|
|
||||||
self->line = NULL;
|
|
||||||
free (self->w);
|
|
||||||
self->w = NULL;
|
|
||||||
self->alloc = 0;
|
|
||||||
self->len = 0;
|
|
||||||
self->point = 0;
|
|
||||||
self->prompt = 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Start the line editor; remember to fill in "change" and "end" callbacks
|
|
||||||
static void
|
|
||||||
line_editor_start (struct line_editor *self, char prompt)
|
|
||||||
{
|
|
||||||
self->alloc = 16;
|
|
||||||
self->line = xcalloc (sizeof *self->line, self->alloc);
|
|
||||||
self->w = xcalloc (sizeof *self->w, self->alloc);
|
|
||||||
self->len = 0;
|
|
||||||
self->point = 0;
|
|
||||||
self->prompt = prompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
static void
|
|
||||||
line_editor_changed (struct line_editor *self)
|
|
||||||
{
|
|
||||||
self->line[self->len] = 0;
|
|
||||||
self->w[self->len] = 0;
|
|
||||||
|
|
||||||
if (self->on_changed)
|
|
||||||
self->on_changed ();
|
|
||||||
}
|
|
||||||
|
|
||||||
static void
|
|
||||||
line_editor_move (struct line_editor *self, int to, int from, int len)
|
|
||||||
{
|
|
||||||
memmove (self->line + to, self->line + from,
|
|
||||||
sizeof *self->line * len);
|
|
||||||
memmove (self->w + to, self->w + from,
|
|
||||||
sizeof *self->w * len);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void
|
|
||||||
line_editor_insert (struct line_editor *self, ucs4_t codepoint)
|
|
||||||
{
|
|
||||||
while (self->alloc - self->len < 2 /* inserted + sentinel */)
|
|
||||||
{
|
|
||||||
self->alloc <<= 1;
|
|
||||||
self->line = xreallocarray
|
|
||||||
(self->line, sizeof *self->line, self->alloc);
|
|
||||||
self->w = xreallocarray
|
|
||||||
(self->w, sizeof *self->w, self->alloc);
|
|
||||||
}
|
|
||||||
|
|
||||||
line_editor_move (self, self->point + 1, self->point,
|
|
||||||
self->len - self->point);
|
|
||||||
self->line[self->point] = codepoint;
|
|
||||||
self->w[self->point] = app_is_character_in_locale (codepoint)
|
|
||||||
? uc_width (codepoint, locale_charset ())
|
|
||||||
: 1 /* the replacement question mark */;
|
|
||||||
|
|
||||||
self->point++;
|
|
||||||
self->len++;
|
|
||||||
line_editor_changed (self);
|
|
||||||
}
|
|
||||||
|
|
||||||
static bool
|
|
||||||
line_editor_action (struct line_editor *self, enum line_editor_action action)
|
|
||||||
{
|
|
||||||
switch (action)
|
|
||||||
{
|
|
||||||
default:
|
|
||||||
return soft_assert (!"unknown line editor action");
|
|
||||||
|
|
||||||
case LINE_EDITOR_B_CHAR:
|
|
||||||
if (self->point < 1)
|
|
||||||
return false;
|
|
||||||
do self->point--;
|
|
||||||
while (self->point > 0
|
|
||||||
&& !self->w[self->point]);
|
|
||||||
return true;
|
|
||||||
case LINE_EDITOR_F_CHAR:
|
|
||||||
if (self->point + 1 > (int) self->len)
|
|
||||||
return false;
|
|
||||||
do self->point++;
|
|
||||||
while (self->point < (int) self->len
|
|
||||||
&& !self->w[self->point]);
|
|
||||||
return true;
|
|
||||||
case LINE_EDITOR_B_WORD:
|
|
||||||
{
|
|
||||||
if (self->point < 1)
|
|
||||||
return false;
|
|
||||||
int i = self->point;
|
|
||||||
while (i && self->line[--i] == ' ');
|
|
||||||
while (i-- && self->line[i] != ' ');
|
|
||||||
self->point = ++i;
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
case LINE_EDITOR_F_WORD:
|
|
||||||
{
|
|
||||||
if (self->point + 1 > (int) self->len)
|
|
||||||
return false;
|
|
||||||
int i = self->point;
|
|
||||||
while (i < (int) self->len && self->line[i] != ' ') i++;
|
|
||||||
while (i < (int) self->len && self->line[i] == ' ') i++;
|
|
||||||
self->point = i;
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
case LINE_EDITOR_HOME:
|
|
||||||
self->point = 0;
|
|
||||||
return true;
|
|
||||||
case LINE_EDITOR_END:
|
|
||||||
self->point = self->len;
|
|
||||||
return true;
|
|
||||||
|
|
||||||
case LINE_EDITOR_B_DELETE:
|
|
||||||
{
|
|
||||||
if (self->point < 1)
|
|
||||||
return false;
|
|
||||||
int len = 1;
|
|
||||||
while (self->point - len > 0
|
|
||||||
&& !self->w[self->point - len])
|
|
||||||
len++;
|
|
||||||
line_editor_move (self, self->point - len, self->point,
|
|
||||||
self->len - self->point);
|
|
||||||
self->len -= len;
|
|
||||||
self->point -= len;
|
|
||||||
line_editor_changed (self);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
case LINE_EDITOR_F_DELETE:
|
|
||||||
{
|
|
||||||
if (self->point + 1 > (int) self->len)
|
|
||||||
return false;
|
|
||||||
int len = 1;
|
|
||||||
while (self->point + len < (int) self->len
|
|
||||||
&& !self->w[self->point + len])
|
|
||||||
len++;
|
|
||||||
self->len -= len;
|
|
||||||
line_editor_move (self, self->point, self->point + len,
|
|
||||||
self->len - self->point);
|
|
||||||
line_editor_changed (self);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
case LINE_EDITOR_B_KILL_WORD:
|
|
||||||
{
|
|
||||||
if (self->point < 1)
|
|
||||||
return false;
|
|
||||||
|
|
||||||
int i = self->point;
|
|
||||||
while (i && self->line[--i] == ' ');
|
|
||||||
while (i-- && self->line[i] != ' ');
|
|
||||||
i++;
|
|
||||||
|
|
||||||
line_editor_move (self, i, self->point, (self->len - self->point));
|
|
||||||
self->len -= self->point - i;
|
|
||||||
self->point = i;
|
|
||||||
line_editor_changed (self);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
case LINE_EDITOR_B_KILL_LINE:
|
|
||||||
self->len -= self->point;
|
|
||||||
line_editor_move (self, 0, self->point, self->len);
|
|
||||||
self->point = 0;
|
|
||||||
line_editor_changed (self);
|
|
||||||
return true;
|
|
||||||
case LINE_EDITOR_F_KILL_LINE:
|
|
||||||
self->len = self->point;
|
|
||||||
line_editor_changed (self);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
static int
|
|
||||||
line_editor_write (const struct line_editor *self, struct row_buffer *row,
|
|
||||||
int width, chtype attrs)
|
|
||||||
{
|
|
||||||
if (self->prompt)
|
|
||||||
{
|
|
||||||
hard_assert (self->prompt < 127);
|
|
||||||
row_buffer_append_c (row, self->prompt, attrs);
|
|
||||||
width--;
|
|
||||||
}
|
|
||||||
|
|
||||||
int following = 0;
|
|
||||||
for (size_t i = self->point; i < self->len; i++)
|
|
||||||
following += self->w[i];
|
|
||||||
|
|
||||||
int preceding = 0;
|
|
||||||
size_t start = self->point;
|
|
||||||
while (start && preceding < width / 2)
|
|
||||||
preceding += self->w[--start];
|
|
||||||
|
|
||||||
// There can be one extra space at the end of the line but this way we
|
|
||||||
// don't need to care about non-spacing marks following full-width chars
|
|
||||||
while (start && width - preceding - following > 2 /* widest char */)
|
|
||||||
preceding += self->w[--start];
|
|
||||||
|
|
||||||
// XXX: we should also show < > indicators for overflow but it'd probably
|
|
||||||
// considerably complicate this algorithm
|
|
||||||
for (; start < self->len; start++)
|
|
||||||
row_buffer_append_c (row, self->line[start], attrs);
|
|
||||||
return !!self->prompt + preceding;
|
|
||||||
}
|
|
|
@ -1,9 +1,8 @@
|
||||||
#include "config.h"
|
|
||||||
|
|
||||||
NONE, Do nothing
|
NONE, Do nothing
|
||||||
|
|
||||||
QUIT, Quit
|
QUIT, Quit
|
||||||
REDRAW, Redraw screen
|
REDRAW, Redraw screen
|
||||||
|
ABORT, Abort
|
||||||
TAB_HELP, Switch to help tab
|
TAB_HELP, Switch to help tab
|
||||||
TAB_LAST, Switch to last tab
|
TAB_LAST, Switch to last tab
|
||||||
TAB_PREVIOUS, Switch to previous tab
|
TAB_PREVIOUS, Switch to previous tab
|
||||||
|
@ -28,23 +27,27 @@ MPD_CONSUME, Toggle consume
|
||||||
MPD_UPDATE_DB, Update MPD database
|
MPD_UPDATE_DB, Update MPD database
|
||||||
MPD_COMMAND, Send raw command to MPD
|
MPD_COMMAND, Send raw command to MPD
|
||||||
|
|
||||||
#ifdef WITH_PULSE
|
.ifdef WITH_PULSE
|
||||||
PULSE_VOLUME_UP, Increase PulseAudio volume
|
PULSE_VOLUME_UP, Increase PulseAudio volume
|
||||||
PULSE_VOLUME_DOWN, Decrease PulseAudio volume
|
PULSE_VOLUME_DOWN, Decrease PulseAudio volume
|
||||||
PULSE_MUTE, Toggle PulseAudio sink mute
|
PULSE_MUTE, Toggle PulseAudio sink mute
|
||||||
#endif
|
.endif
|
||||||
|
|
||||||
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
|
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
|
||||||
|
|
||||||
|
GOTO_PLAYING, Go to playing song
|
||||||
|
|
||||||
GOTO_TOP, Go to top
|
GOTO_TOP, Go to top
|
||||||
GOTO_BOTTOM, Go to bottom
|
GOTO_BOTTOM, Go to bottom
|
||||||
GOTO_ITEM_PREVIOUS, Go to previous item
|
GOTO_ITEM_PREVIOUS, Go to previous item
|
||||||
|
@ -65,6 +68,10 @@ EDITOR_F_WORD, Go forward a word
|
||||||
EDITOR_HOME, Go to start of line
|
EDITOR_HOME, Go to start of line
|
||||||
EDITOR_END, Go to end of line
|
EDITOR_END, Go to end of line
|
||||||
|
|
||||||
|
EDITOR_UPCASE_WORD, Convert word to uppercase
|
||||||
|
EDITOR_DOWNCASE_WORD, Convert word to lowercase
|
||||||
|
EDITOR_CAPITALIZE_WORD, Capitalize word
|
||||||
|
|
||||||
EDITOR_B_DELETE, Delete last character
|
EDITOR_B_DELETE, Delete last character
|
||||||
EDITOR_F_DELETE, Delete next character
|
EDITOR_F_DELETE, Delete next character
|
||||||
EDITOR_B_KILL_WORD, Delete last word
|
EDITOR_B_KILL_WORD, Delete last word
|
||||||
|
|
|
@ -0,0 +1,106 @@
|
||||||
|
# nncmpp.actions.awk: produce C code for a list of user actions
|
||||||
|
#
|
||||||
|
# Copyright (c) 2022, Přemysl Eric Janouch <p@janouch.name>
|
||||||
|
# SPDX-License-Identifier: 0BSD
|
||||||
|
#
|
||||||
|
# Usage: env LC_ALL=C A=0 B=1 awk -f nncmpp.actions.awk \
|
||||||
|
# nncmpp.actions > nncmpp-actions.h
|
||||||
|
|
||||||
|
# --- Preprocessor -------------------------------------------------------------
|
||||||
|
|
||||||
|
function fatal(message) {
|
||||||
|
print "// " FILENAME ":" FNR ": fatal error: " message
|
||||||
|
print FILENAME ":" FNR ": fatal error: " message > "/dev/stderr"
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
function condition(pass, passing, a, i) {
|
||||||
|
split(substr($0, RSTART + RLENGTH), a, /[[:space:]]+/)
|
||||||
|
if (!(1 in a))
|
||||||
|
fatal("missing condition")
|
||||||
|
|
||||||
|
passing = 0
|
||||||
|
for (i in a)
|
||||||
|
if (a[i] && !pass == !ENVIRON[a[i]])
|
||||||
|
passing = 1
|
||||||
|
|
||||||
|
while (getline > 0) {
|
||||||
|
if (match($0, /^[[:space:]]*[.]endif[[:space:]]*$/))
|
||||||
|
return 1
|
||||||
|
|
||||||
|
if (match($0, /^[[:space:]]*[.]else[[:space:]]*$/))
|
||||||
|
passing = !passing
|
||||||
|
else if (!directive() && passing)
|
||||||
|
process()
|
||||||
|
}
|
||||||
|
|
||||||
|
fatal("unterminated condition body")
|
||||||
|
}
|
||||||
|
|
||||||
|
# Multiple arguments mean logical OR, multiple directives mean logical AND.
|
||||||
|
# Similar syntax is also used by Exim, BSD make, or various assemblers.
|
||||||
|
#
|
||||||
|
# Looking at what others have picked for their preprocessor syntax:
|
||||||
|
# {OpenGL, FreeBASIC} reuse #ifdef, which would be confusing with C code around,
|
||||||
|
# {Mental Ray, RapidQ and UniVerse BASIC} use $ifdef, NSIS has !ifdef,
|
||||||
|
# and Verilog went for `ifdef. Not much more can be easily found.
|
||||||
|
function directive() {
|
||||||
|
sub(/#.*/, "")
|
||||||
|
if (match($0, /^[[:space:]]*[.]ifdef[[:space:]]+/))
|
||||||
|
return condition(1)
|
||||||
|
if (match($0, /^[[:space:]]*[.]ifndef[[:space:]]+/))
|
||||||
|
return condition(0)
|
||||||
|
if (/^[[:space:]]*[.]/)
|
||||||
|
fatal("unexpected or unsupported directive")
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
!directive() {
|
||||||
|
process()
|
||||||
|
}
|
||||||
|
|
||||||
|
# --- Postprocessor ------------------------------------------------------------
|
||||||
|
|
||||||
|
function strip(string) {
|
||||||
|
gsub(/^[[:space:]]*|[[:space:]]*$/, "", string)
|
||||||
|
return string
|
||||||
|
}
|
||||||
|
|
||||||
|
function process( constant, name, description) {
|
||||||
|
if (match($0, /,/)) {
|
||||||
|
constant = name = strip(substr($0, 1, RSTART - 1))
|
||||||
|
description = strip(substr($0, RSTART + RLENGTH))
|
||||||
|
gsub(/_/, "-", name)
|
||||||
|
|
||||||
|
N++
|
||||||
|
Constants[N] = constant
|
||||||
|
Names[N] = tolower(name)
|
||||||
|
Descriptions[N] = description
|
||||||
|
} else if (/[^[:space:]]/) {
|
||||||
|
fatal("invalid action definition syntax")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function tocstring(string) {
|
||||||
|
gsub(/\\/, "\\\\", string)
|
||||||
|
gsub(/"/, "\\\"", string)
|
||||||
|
return "\"" string "\""
|
||||||
|
}
|
||||||
|
|
||||||
|
END {
|
||||||
|
print "enum action {"
|
||||||
|
for (i in Constants)
|
||||||
|
print "\t" "ACTION_" Constants[i] ","
|
||||||
|
print "\t" "ACTION_COUNT"
|
||||||
|
print "};"
|
||||||
|
print ""
|
||||||
|
print "static const char *g_action_names[] = {"
|
||||||
|
for (i in Names)
|
||||||
|
print "\t" tocstring(Names[i]) ","
|
||||||
|
print "};"
|
||||||
|
print ""
|
||||||
|
print "static const char *g_action_descriptions[] = {"
|
||||||
|
for (i in Descriptions)
|
||||||
|
print "\t" tocstring(Descriptions[i]) ","
|
||||||
|
print "};"
|
||||||
|
}
|
46
nncmpp.adoc
46
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 = ""
|
||||||
|
@ -64,18 +69,22 @@ colors = {
|
||||||
scrollbar = ""
|
scrollbar = ""
|
||||||
}
|
}
|
||||||
streams = {
|
streams = {
|
||||||
"dnbradio.com" = "http://www.dnbradio.com/hi.m3u"
|
"dnbradio.com" = "https://dnbradio.com/hi.pls"
|
||||||
"BassDrive.com" = "http://bassdrive.com/v2/streams/BassDrive.pls"
|
"BassDrive.com" = "http://bassdrive.com/v2/streams/BassDrive.pls"
|
||||||
}
|
}
|
||||||
....
|
....
|
||||||
|
|
||||||
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).
|
||||||
|
|
||||||
|
To adjust key bindings, put them within a *normal* or *editor* object.
|
||||||
|
Run *nncmpp* with the *--debug* option to find out key combinations names.
|
||||||
|
Press *?* in the help tab to learn the action identifiers to use.
|
||||||
|
|
||||||
Spectrum visualiser
|
Spectrum visualiser
|
||||||
-------------------
|
-------------------
|
||||||
When built against the FFTW library, *nncmpp* can make use of MPD's "fifo"
|
When built against the FFTW library, *nncmpp* can make use of MPD's "fifo"
|
||||||
|
@ -108,8 +117,8 @@ as in the snippet above. To replace the default volume control bindings, use:
|
||||||
|
|
||||||
....
|
....
|
||||||
normal = {
|
normal = {
|
||||||
"M-PageUp" = "pulse-volume-up"
|
"+" = "pulse-volume-up"
|
||||||
"M-PageDown" = "pulse-volume-down"
|
"-" = "pulse-volume-down"
|
||||||
}
|
}
|
||||||
....
|
....
|
||||||
|
|
||||||
|
@ -119,6 +128,19 @@ For this to work, *nncmpp* needs to access the right PulseAudio daemon--in case
|
||||||
your setup is unusual, consult the list of environment variables in
|
your setup is unusual, consult the list of environment variables in
|
||||||
*pulseaudio*(1). MPD-compatibles are currently unsupported.
|
*pulseaudio*(1). MPD-compatibles are currently unsupported.
|
||||||
|
|
||||||
|
Info plugins
|
||||||
|
------------
|
||||||
|
You can invoke various plugins from the Info tab, for example to look up
|
||||||
|
song lyrics.
|
||||||
|
|
||||||
|
Plugins can be arbitrary scripts or binaries. When run without command line
|
||||||
|
arguments, a plugin outputs a user interface description of what it does.
|
||||||
|
When invoked by a user, it receives the following self-explanatory arguments:
|
||||||
|
_TITLE_ _ARTIST_ [_ALBUM_], and anything it writes to its standard output
|
||||||
|
or standard error stream is presented back to the user. Here, bold and italic
|
||||||
|
formatting can be toggled with ASCII control characters 1 (SOH) and 2 (STX),
|
||||||
|
respectively. Otherwise, all input and output makes use of the UTF-8 encoding.
|
||||||
|
|
||||||
Files
|
Files
|
||||||
-----
|
-----
|
||||||
*nncmpp* follows the XDG Base Directory Specification.
|
*nncmpp* follows the XDG Base Directory Specification.
|
||||||
|
@ -126,6 +148,14 @@ Files
|
||||||
_~/.config/nncmpp/nncmpp.conf_::
|
_~/.config/nncmpp/nncmpp.conf_::
|
||||||
The configuration file.
|
The configuration file.
|
||||||
|
|
||||||
|
_~/.local/share/nncmpp/info/_::
|
||||||
|
_/usr/local/share/nncmpp/info/_::
|
||||||
|
_/usr/share/nncmpp/info/_::
|
||||||
|
Info plugins are loaded from these directories, in order,
|
||||||
|
then listed lexicographically.
|
||||||
|
Only the first occurence of a particular filename is used,
|
||||||
|
and empty files act as silent disablers.
|
||||||
|
|
||||||
Reporting bugs
|
Reporting bugs
|
||||||
--------------
|
--------------
|
||||||
Use https://git.janouch.name/p/nncmpp to report bugs, request features,
|
Use https://git.janouch.name/p/nncmpp to report bugs, request features,
|
||||||
|
|
|
@ -0,0 +1,9 @@
|
||||||
|
[Desktop Entry]
|
||||||
|
Type=Application
|
||||||
|
Name=nncmpp
|
||||||
|
GenericName=MPD client
|
||||||
|
Icon=nncmpp
|
||||||
|
Exec=nncmpp %U
|
||||||
|
StartupNotify=false
|
||||||
|
# Not registering a MimeType, because that depends on MPD.
|
||||||
|
Categories=AudioVideo;Audio;Player;
|
BIN
nncmpp.png
BIN
nncmpp.png
Binary file not shown.
Before Width: | Height: | Size: 4.6 KiB After Width: | Height: | Size: 35 KiB |
|
@ -0,0 +1,9 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||||
|
<svg version="1.0" width="48" height="48" viewBox="0 0 48 48"
|
||||||
|
xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<g transform="translate(5 4) scale(2 2)">
|
||||||
|
<!-- From x11_icon_play, with a stroke for contrast. -->
|
||||||
|
<path d="M 0 0 20 10 0 20 Z" stroke="#eee" stroke-width="2" fill="#000"
|
||||||
|
stroke-linejoin="round" />
|
||||||
|
</g>
|
||||||
|
</svg>
|
After Width: | Height: | Size: 385 B |
2
termo
2
termo
|
@ -1 +1 @@
|
||||||
Subproject commit 8265f075b176b33680012094aa1ced5721e55ac9
|
Subproject commit 2518b53e5ae4579bf84ed58fa7a62806f64e861c
|
Loading…
Reference in New Issue