diff --git a/Makefile.am b/Makefile.am index 28f5b24..d7daff1 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1,6 +1,6 @@ ## Process this file with automake to generate a Makefile.in -SUBDIRS = src +SUBDIRS = minidocs src ACLOCAL_AMFLAGS = -I m4 diff --git a/README.md b/README.md index 6934e37..e31776d 100644 --- a/README.md +++ b/README.md @@ -2,22 +2,21 @@ Infinity ======== Visualization plugin for [Audacious](http://audacious-media-player.org/) music player. -It generates beautiful light effects. +It generates beautiful light effects. Supports full-screen mode, mouse resizing and preferences +saving. ![Screenshot of Infinity](https://a.fsdn.com/con/app/proj/infinity-plugin/screenshots/Infinity.png) Requirements ------------ -- Audacious >= 3.5 -- Audclient >= 3.5 (Audacious remote control library) -- 1.0.6 <= SDL < 2 -- Glib >= 2.8 -- Gtk+ >= 2.8 +Audacious >= 3.5, Audclient >= 3.5, 1.0.6 <= SDL < 2, Glib >= 2.8, Gtk+ >= 2.8 **Install deps in Ubuntu** +``` sudo apt -y install audacious-dev libaudclient-dev libsdl1.2-dev libglib2.0-dev libgtk2.0-dev +``` Install from tarball ------- @@ -38,72 +37,22 @@ Install from repo Run --- -- start Audacious -- enter menu View -> Visualizations -- mark Infinity -- play your favorite songs +Audacious -> View -> Visualizations -> Infinity -Enter / leave full-screen by pressing Tab. +Enter / leave full-screen by pressing `Tab`. ![Screenshot of Infinity Settings](../screenshots/screenshot-settings.png?raw=true "Infinity Settings") -Add New Effects ---------------- +Playing Around +-------------- -- Build with --enable-debug and install -- Run Audacious on console -- Go to interactive mode (see next section) and experiment -- Press key 'm' for saving current effect to disk (will persist amongst Audacious sessions) - -Modes ------ - -The plugin has two modes. Default is Non-Interactive. - -**Non-Interactive Mode**: - -States and palettes periodically switches in a random sequence. - -If you run Audacity from a terminal the following command keys will display on -terminal when Infinity loads: - - Keys: - - Space: change effect - - Tab: toggle full-screen - - Up/Down: up/down audacity main volume - - Left/Right: reward/forward actual played song, if any - - z: previous song - - x: play - - c: pause - - v: stop - - b: next song - - Enter: switch to interactive mode - (works only if infinity was configured with --enable-debug option) - - F11: screenshot - - F12: change palette - -**Interactive Mode**: - -You can control the effects using keys: - - - F12: change palette - - Tab: toggle full-screen - - Enter: switch to non-interactive mode - - F1-F10: choose transformation vector field - - a,z: change curve 1 lighting - - q,s: change curve 2 lighting - - e,r: change curve 1 amplitude - - d,f: change curve 2 amplitude - - w: change curve 2 type - - m: persist current effect - - mouse: change curve 2 position - - F11: screenshot +See [how to add new effects or how to control the plugin with the keyboard](minidocs/controlkeys.md). Known Bugs ---------- -In Ubuntu systems over AMD64 architectures, try running configure with ---prefix=/usr --libdir=/usr/lib/x86_64-linux-gnu +In Ubuntu systems over AMD64 architectures, try configure with +``--prefix=/usr --libdir=/usr/lib/x86_64-linux-gnu`` If you found a bug please report it at . diff --git a/configure.ac b/configure.ac index 8a71838..21663dd 100644 --- a/configure.ac +++ b/configure.ac @@ -1,7 +1,7 @@ ## Process this file with autoconf to produce a configure script. AC_PREREQ(2.65) -AC_INIT([Infinity plugin],[0.9.0alpha],[https://github.com/dprotti/infinity-plugin/issues],[infinity-plugin-4-audacious],[https://github.com/dprotti/infinity-plugin]) +AC_INIT([Infinity plugin],[0.9.0alpha],[https://github.com/dprotti/infinity-plugin/issues],[infinity-plugin-4-audacious],[https://dprotti.github.io/infinity-plugin]) AC_CANONICAL_HOST AC_CANONICAL_TARGET @@ -183,6 +183,7 @@ AC_SUBST(libdir) AC_SUBST(pkglibdir) AC_CONFIG_FILES([Makefile + minidocs/Makefile src/Makefile]) AC_OUTPUT diff --git a/minidocs/Makefile.am b/minidocs/Makefile.am new file mode 100644 index 0000000..64f4161 --- /dev/null +++ b/minidocs/Makefile.am @@ -0,0 +1,4 @@ +## Process this file with automake to generate a Makefile.in + +EXTRA_DIST = controlkeys.md + diff --git a/minidocs/controlkeys.md b/minidocs/controlkeys.md new file mode 100644 index 0000000..a88482c --- /dev/null +++ b/minidocs/controlkeys.md @@ -0,0 +1,54 @@ +How to control Infinity by using the keyboard. +How to add new effects. + +Adding New Effects +------------------ + +- Build with --enable-debug and install +- Run Audacious on console +- Go to interactive mode (see next section) and experiment +- Press key 'm' for saving current effect to disk (will persist amongst Audacious sessions) + +Modes +----- + +The plugin has two modes. Default is Non-Interactive. + +**Non-Interactive Mode**: + +States and palettes periodically switches in a random sequence. + +If you run Audacity from a terminal the following command keys will display on +terminal when Infinity loads: + + Keys: + - Space: change effect + - Tab: toggle full-screen + - Up/Down: up/down audacity main volume + - Left/Right: reward/forward actual played song, if any + - z: previous song + - x: play + - c: pause + - v: stop + - b: next song + - Enter: switch to interactive mode + (works only if infinity was configured with --enable-debug option) + - F11: screenshot + - F12: change palette + +**Interactive Mode**: + +You can control the effects using keys: + + - F12: change palette + - Tab: toggle full-screen + - Enter: switch to non-interactive mode + - F1-F10: choose transformation vector field + - a,z: change curve 1 lighting + - q,s: change curve 2 lighting + - e,r: change curve 1 amplitude + - d,f: change curve 2 amplitude + - w: change curve 2 type + - m: persist current effect + - mouse: change curve 2 position + - F11: screenshot diff --git a/src/main.cc b/src/main.cc index ccd161e..9d2f424 100644 --- a/src/main.cc +++ b/src/main.cc @@ -28,7 +28,7 @@ extern "C" { static const char about_text[] = "Infinity " PACKAGE_VERSION "\n\n" "Julien Carme, Duilio Protti\n\n" - "https://github.com/dprotti/infinity-plugin"; + "https://dprotti.github.io/infinity-plugin"; static const PreferencesWidget prefs_fps[] = { WidgetLabel ("Frames per second"),