src/command.c

   1 /* ncmpc (Ncurses MPD Client)
   2  * (c) 2004-2010 The Music Player Daemon Project
   3  * Project homepage: http://musicpd.org
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18  */
  19
  20 #include "command.h"
  21 #include "config.h"
  22 #include "ncmpc.h"
  23 #include "i18n.h"
  24 #include "mpdclient.h"
  25 #include "screen.h"
  26
  27 #include <ctype.h>
  28 #include <stdlib.h>
  29 #include <string.h>
  30 #include <ctype.h>
  31 #include <glib.h>
  32 #include <signal.h>
  33 #include <unistd.h>
  34
  35 #undef DEBUG_KEYS
  36
  37 #ifdef DEBUG_KEYS
  38 #define DK(x) x
  39 #else
  40 #define DK(x)
  41 #endif
  42
  43 #define KEY_CTL(x) ((x) & 0x1f) /* KEY_CTL(A) == ^A == \1 */
  44
  45 #define BS   KEY_BACKSPACE
  46 #define DEL  KEY_DC
  47 #define UP   KEY_UP
  48 #define DWN  KEY_DOWN
  49 #define LEFT KEY_LEFT
  50 #define RGHT KEY_RIGHT
  51 #define HOME KEY_HOME
  52 #define END  KEY_END
  53 #define PGDN KEY_NPAGE
  54 #define PGUP KEY_PPAGE
  55 #define TAB  0x09
  56 #define STAB 0x161
  57 #define ESC  0x1B
  58 #define RET  '\r'
  59 #define F1   KEY_F(1)
  60 #define F2   KEY_F(2)
  61 #define F3   KEY_F(3)
  62 #define F4   KEY_F(4)
  63 #define F5   KEY_F(5)
  64 #define F6   KEY_F(6)
  65 #define F7   KEY_F(7)
  66 #define F8   KEY_F(8)
  67 #define C(x) KEY_CTL(x)
  68
  69 static command_definition_t cmds[] = {
  70 #ifdef ENABLE_KEYDEF_SCREEN
  71         { {'K', 0, 0 }, 0, CMD_SCREEN_KEYDEF, "screen-keyedit",
  72           N_("Key configuration screen") },
  73 #endif
  74         { { 'q', 'Q', C('C') }, 0, CMD_QUIT, "quit",
  75           N_("Quit") },
  76
  77         /* movement */
  78         { { UP, 'k', 0 }, 0, CMD_LIST_PREVIOUS, "up",
  79           N_("Move cursor up") },
  80         { { DWN, 'j', 0 }, 0, CMD_LIST_NEXT, "down",
  81           N_("Move cursor down") },
  82         { { 'H', 0, 0 }, 0, CMD_LIST_TOP, "top",
  83           N_("Move cursor to the top of screen") },
  84         { { 'M', 0, 0 }, 0, CMD_LIST_MIDDLE, "middle",
  85           N_("Move cursor to the middle of screen") },
  86         { { 'L', 0, 0 }, 0, CMD_LIST_BOTTOM, "bottom",
  87           N_("Move cursor to the bottom of screen") },
  88         { { HOME, C('A'), 0 }, 0, CMD_LIST_FIRST, "home",
  89           N_("Move cursor to the top of the list") },
  90         { { END, C('E'), 0 }, 0, CMD_LIST_LAST, "end",
  91           N_("Move cursor to the bottom of the list") },
  92         { { PGUP, 0, 0 }, 0, CMD_LIST_PREVIOUS_PAGE, "pgup",
  93           N_("Page up") },
  94         { { PGDN, 0, 0 }, 0, CMD_LIST_NEXT_PAGE, "pgdn",
  95           N_("Page down") },
  96         { { 'v',  0, 0 }, 0, CMD_LIST_RANGE_SELECT, "range-select",
  97           N_("Range selection") },
  98         { { C('N'),  0, 0 }, 0, CMD_LIST_SCROLL_DOWN_LINE, "scroll-down-line",
  99           N_("Scroll up one line") },
 100         { { C('B'),  0, 0 }, 0, CMD_LIST_SCROLL_UP_LINE, "scroll-up-line",
 101           N_("Scroll down one line") },
 102         { { 'N',  0, 0 }, 0, CMD_LIST_SCROLL_DOWN_HALF, "scroll-down-half",
 103           N_("Scroll up half a screen") },
 104         { { 'B',  0, 0 }, 0, CMD_LIST_SCROLL_UP_HALF, "scroll-up-half",
 105           N_("Scroll down half a screen") },
 106         { { 'l', 0, 0 }, 0, CMD_SELECT_PLAYING, "select-playing",
 107           N_("Select currently playing song") },
 108
 109
 110         /* basic screens */
 111         { { '1', F1, 'h' }, 0, CMD_SCREEN_HELP, "screen-help",
 112           N_("Help screen") },
 113         { { '2', F2, 0 }, 0, CMD_SCREEN_PLAY, "screen-playlist",
 114           N_("Playlist screen") },
 115         { { '3', F3, 0 }, 0, CMD_SCREEN_FILE, "screen-browse",
 116           N_("Browse screen") },
 117
 118
 119         /* player commands */
 120         { { RET, 0, 0 }, 0, CMD_PLAY, "play",
 121           N_("Play/Enter directory") },
 122         { { 'P', 0, 0 }, 0, CMD_PAUSE,"pause",
 123           N_("Pause") },
 124         { { 's', BS, 0 }, 0, CMD_STOP, "stop",
 125           N_("Stop") },
 126         { { 'o', 0, 0 }, 0, CMD_CROP, "crop",
 127           N_("Crop") },
 128         { { '>', 0, 0 }, 0, CMD_TRACK_NEXT, "next",
 129           N_("Next track") },
 130         { { '<', 0, 0 }, 0, CMD_TRACK_PREVIOUS, "prev",
 131           N_("Previous track") },
 132         { { 'f', 0, 0 }, 0, CMD_SEEK_FORWARD, "seek-forward",
 133           N_("Seek forward") },
 134         { { 'b', 0, 0 }, 0, CMD_SEEK_BACKWARD, "seek-backward",
 135           N_("Seek backward") },
 136         { { '+', RGHT, 0 }, 0, CMD_VOLUME_UP, "volume-up",
 137           N_("Increase volume") },
 138         { { '-', LEFT, 0 }, 0, CMD_VOLUME_DOWN, "volume-down",
 139           N_("Decrease volume") },
 140         { { ' ', 0, 0 }, 0, CMD_SELECT, "select",
 141           N_("Select/deselect song in playlist") },
 142         { { 't', 0, 0 }, 0, CMD_SELECT_ALL, "select_all",
 143           N_("Select all listed items") },
 144         { { DEL, 'd', 0 }, 0, CMD_DELETE, "delete",
 145           N_("Delete song from playlist") },
 146         { { 'Z', 0, 0 }, 0, CMD_SHUFFLE, "shuffle",
 147           N_("Shuffle playlist") },
 148         { { 'c', 0, 0 }, 0, CMD_CLEAR, "clear",
 149           N_("Clear playlist") },
 150         { { 'r', 0, 0 }, 0, CMD_REPEAT, "repeat",
 151           N_("Toggle repeat mode") },
 152         { { 'z', 0, 0 }, 0, CMD_RANDOM, "random",
 153           N_("Toggle random mode") },
 154         { { 'y', 0, 0 }, 0, CMD_SINGLE, "single",
 155           N_("Toggle single mode") },
 156         { { 'C', 0, 0 }, 0, CMD_CONSUME, "consume",
 157           N_("Toggle consume mode") },
 158         { { 'x', 0, 0 }, 0, CMD_CROSSFADE, "crossfade",
 159           N_("Toggle crossfade mode") },
 160         { { C('U'), 0, 0 }, 0, CMD_DB_UPDATE, "db-update",
 161           N_("Start a music database update") },
 162         { { 'S', 0, 0 }, 0, CMD_SAVE_PLAYLIST, "save",
 163           N_("Save playlist") },
 164         { { 'a', 0, 0 }, 0, CMD_ADD, "add",
 165           N_("Add url/file to playlist") },
 166
 167         { { '!', 0, 0 }, 0, CMD_GO_ROOT_DIRECTORY, "go-root-directory",
 168           N_("Go to root directory") },
 169         { { '"', 0, 0 }, 0, CMD_GO_PARENT_DIRECTORY, "go-parent-directory",
 170           N_("Go to parent directory") },
 171
 172         { { 'G', 0, 0 }, 0, CMD_LOCATE, "locate",
 173           N_("Locate song in browser") },
 174
 175         /* lists */
 176         { { C('K'), 0, 0 }, 0, CMD_LIST_MOVE_UP, "move-up",
 177           N_("Move item up") },
 178         { { C('J'), 0, 0 }, 0, CMD_LIST_MOVE_DOWN, "move-down",
 179           N_("Move item down") },
 180         { { C('L'), 0, 0 }, 0, CMD_SCREEN_UPDATE, "update",
 181           N_("Refresh screen") },
 182
 183
 184         /* ncmpc options */
 185         { { 'w', 0, 0 }, 0, CMD_TOGGLE_FIND_WRAP, "wrap-mode",
 186           /* translators: toggle between wrapping and non-wrapping
 187              search */
 188           N_("Toggle find mode") },
 189         { { 'U', 0, 0 }, 0, CMD_TOGGLE_AUTOCENTER, "autocenter-mode",
 190           /* translators: the auto center mode always centers the song
 191              currently being played */
 192           N_("Toggle auto center mode") },
 193
 194
 195         /* change screen */
 196         { { TAB, 0, 0 }, 0, CMD_SCREEN_NEXT, "screen-next",
 197           N_("Next screen") },
 198         { { STAB, 0, 0 }, 0, CMD_SCREEN_PREVIOUS, "screen-prev",
 199           N_("Previous screen") },
 200         { { '`', 0, 0 }, 0, CMD_SCREEN_SWAP, "screen-swap",
 201           N_("Swap to most recent screen") },
 202
 203
 204         /* find */
 205         { { '/', 0, 0 }, 0, CMD_LIST_FIND, "find",
 206           N_("Forward find") },
 207         { { 'n', 0, 0 }, 0, CMD_LIST_FIND_NEXT, "find-next",
 208           N_("Forward find next") },
 209         { { '?', 0, 0 }, 0, CMD_LIST_RFIND, "rfind",
 210           N_("Backward find") },
 211         { { 'p', 0, 0 }, 0, CMD_LIST_RFIND_NEXT, "rfind-next",
 212           N_("Backward find previous") },
 213         { { '.', 0, 0 }, 0, CMD_LIST_JUMP, "jump",
 214                 /* translators: this queries the user for a string
 215                  * and jumps directly (while the user is typing)
 216                  * to the entry which begins with this string */
 217           N_("Jump to") },
 218
 219
 220         /* extra screens */
 221 #ifdef ENABLE_ARTIST_SCREEN
 222         { {'4', F4, 0 }, 0, CMD_SCREEN_ARTIST, "screen-artist",
 223           N_("Artist screen") },
 224 #endif
 225 #ifdef ENABLE_SEARCH_SCREEN
 226         { {'5', F5, 0 }, 0, CMD_SCREEN_SEARCH, "screen-search",
 227           N_("Search screen") },
 228         { {'m', 0, 0 }, 0, CMD_SEARCH_MODE, "search-mode",
 229           N_("Change search mode") },
 230 #endif
 231 #ifdef ENABLE_SONG_SCREEN
 232         { { 'i', 0, 0 }, 0, CMD_SCREEN_SONG, "view",
 233           N_("View the selected and the currently playing song") },
 234 #endif
 235 #ifdef ENABLE_LYRICS_SCREEN
 236         { {'7', F7, 0 }, 0, CMD_SCREEN_LYRICS, "screen-lyrics",
 237           N_("Lyrics screen") },
 238         { {ESC, 0, 0 }, 0, CMD_INTERRUPT, "lyrics-interrupt",
 239           /* translators: interrupt the current background action,
 240              e.g. stop loading lyrics from the internet */
 241           N_("Interrupt action") },
 242         { {'u', 0, 0 }, 0, CMD_LYRICS_UPDATE, "lyrics-update",
 243           N_("Update Lyrics") },
 244         { {'e', 0, 0 }, 0, CMD_LYRICS_EDIT, "lyrics-edit",
 245           N_("Edit Lyrics") },
 246 #endif
 247
 248 #ifdef ENABLE_OUTPUTS_SCREEN
 249         { {'8', F8, 0 }, 0, CMD_SCREEN_OUTPUTS, "screen-outputs",
 250           N_("Outputs screen") },
 251 #endif
 252
 253
 254         { { -1, -1, -1 }, 0, CMD_NONE, NULL, NULL }
 255 };
 256
 257 #ifdef ENABLE_KEYDEF_SCREEN
 258 command_definition_t *
 259 get_command_definitions(void)
 260 {
 261         return cmds;
 262 }
 263 #endif
 264
 265 const char *
 266 key2str(int key)
 267 {
 268         static char buf[32];
 269         int i;
 270
 271         buf[0] = 0;
 272         switch(key) {
 273         case 0:
 274                 return _("Undefined");
 275         case ' ':
 276                 return _("Space");
 277         case RET:
 278                 return _("Enter");
 279         case BS:
 280                 return _("Backspace");
 281         case DEL:
 282                 return _("Delete");
 283         case UP:
 284                 return _("Up");
 285         case DWN:
 286                 return _("Down");
 287         case LEFT:
 288                 return _("Left");
 289         case RGHT:
 290                 return _("Right");
 291         case HOME:
 292                 return _("Home");
 293         case END:
 294                 return _("End");
 295         case PGDN:
 296                 return _("PageDown");
 297         case PGUP:
 298                 return _("PageUp");
 299         case TAB:
 300                 return _("Tab");
 301         case STAB:
 302                 return _("Shift+Tab");
 303         case ESC:
 304                 return _("Esc");
 305         case KEY_IC:
 306                 return _("Insert");
 307         default:
 308                 for (i = 0; i <= 63; i++)
 309                         if (key == KEY_F(i)) {
 310                                 g_snprintf(buf, 32, "F%d", i );
 311                                 return buf;
 312                         }
 313                 if (!(key & ~037))
 314                         g_snprintf(buf, 32, "Ctrl-%c", 'A'+(key & 037)-1 );
 315                 else if ((key & ~037) == 224)
 316                         g_snprintf(buf, 32, "Alt-%c", 'A'+(key & 037)-1 );
 317                 else if (key > 32 && key < 256)
 318                         g_snprintf(buf, 32, "%c", key);
 319                 else
 320                         g_snprintf(buf, 32, "0x%03X", key);
 321         }
 322
 323         return buf;
 324 }
 325
 326 void
 327 command_dump_keys(void)
 328 {
 329         int i = 0;
 330
 331         while (cmds[i].description) {
 332                 if (cmds[i].command != CMD_NONE)
 333                         printf(" %20s : %s\n", get_key_names(cmds[i].command,1),cmds[i].name);
 334                 i++;
 335         }
 336 }
 337
 338 #ifndef NCMPC_MINI
 339
 340 static int
 341 set_key_flags(command_definition_t *cp, command_t command, int flags)
 342 {
 343         int i = 0;
 344
 345         while (cp[i].name) {
 346                 if (cp[i].command == command) {
 347                         cp[i].flags |= flags;
 348                         return 0;
 349                 }
 350                 i++;
 351         }
 352
 353         return 1;
 354 }
 355
 356 #endif
 357
 358 const char *
 359 get_key_names(command_t command, int all)
 360 {
 361         int i = 0;
 362
 363         while (cmds[i].description) {
 364                 if (cmds[i].command == command) {
 365                         int j;
 366                         static char keystr[80];
 367
 368                         g_strlcpy(keystr, key2str(cmds[i].keys[0]), sizeof(keystr));
 369                         if (!all)
 370                                 return keystr;
 371                         j=1;
 372                         while (j < MAX_COMMAND_KEYS && cmds[i].keys[j] > 0) {
 373                                 g_strlcat(keystr, " ", sizeof(keystr));
 374                                 g_strlcat(keystr, key2str(cmds[i].keys[j]), sizeof(keystr));
 375                                 j++;
 376                         }
 377                         return keystr;
 378                 }
 379                 i++;
 380         }
 381         return NULL;
 382 }
 383
 384 const char *
 385 get_key_description(command_t command)
 386 {
 387         int i = 0;
 388
 389         while (cmds[i].description) {
 390                 if (cmds[i].command == command)
 391                         return _(cmds[i].description);
 392                 i++;
 393         }
 394
 395         return NULL;
 396 }
 397
 398 const char *
 399 get_key_command_name(command_t command)
 400 {
 401         int i = 0;
 402
 403         while (cmds[i].name) {
 404                 if (cmds[i].command == command)
 405                         return cmds[i].name;
 406                 i++;
 407         }
 408         return NULL;
 409 }
 410
 411 command_t
 412 get_key_command_from_name(char *name)
 413 {
 414         int i = 0;
 415
 416         while (cmds[i].name) {
 417                 if (strcmp(name, cmds[i].name) == 0)
 418                         return cmds[i].command;
 419                 i++;
 420         }
 421
 422         return CMD_NONE;
 423 }
 424
 425 command_t
 426 find_key_command(int key, command_definition_t *c)
 427 {
 428         int i = 0;
 429
 430         while (key && c && c[i].name) {
 431                 if (c[i].keys[0] == key ||
 432                     c[i].keys[1] == key ||
 433                     c[i].keys[2] == key)
 434                         return c[i].command;
 435                 i++;
 436         }
 437
 438         return CMD_NONE;
 439 }
 440
 441 command_t
 442 get_key_command(int key)
 443 {
 444         return find_key_command(key, cmds);
 445 }
 446
 447 command_t
 448 get_keyboard_command(void)
 449 {
 450         int key;
 451
 452         key = wgetch(stdscr);
 453         if (key == ERR)
 454                 return CMD_NONE;
 455
 456 #ifdef HAVE_GETMOUSE
 457         if (key == KEY_MOUSE)
 458                 return CMD_MOUSE_EVENT;
 459 #endif
 460
 461         return get_key_command(key);
 462 }
 463
 464 int
 465 assign_keys(command_t command, int keys[MAX_COMMAND_KEYS])
 466 {
 467         int i = 0;
 468
 469         while (cmds[i].name) {
 470                 if (cmds[i].command == command) {
 471                         memcpy(cmds[i].keys, keys, sizeof(int)*MAX_COMMAND_KEYS);
 472 #ifndef NCMPC_MINI
 473                         cmds[i].flags |= COMMAND_KEY_MODIFIED;
 474 #endif
 475                         return 0;
 476                 }
 477                 i++;
 478         }
 479         return -1;
 480 }
 481
 482 #ifndef NCMPC_MINI
 483
 484 int
 485 check_key_bindings(command_definition_t *cp, char *buf, size_t bufsize)
 486 {
 487         int i;
 488         int retval = 0;
 489
 490         if (cp == NULL)
 491                 cp = cmds;
 492
 493         for (i = 0; cp[i].name; i++)
 494                 cp[i].flags &= ~COMMAND_KEY_CONFLICT;
 495
 496         for (i = 0; cp[i].name; i++) {
 497                 int j;
 498                 command_t cmd;
 499
 500                 for(j=0; j<MAX_COMMAND_KEYS; j++) {
 501                         if (cp[i].keys[j] &&
 502                             (cmd = find_key_command(cp[i].keys[j],cp)) != cp[i].command) {
 503                                 if (buf) {
 504                                         g_snprintf(buf, bufsize,
 505                                                    _("Key %s assigned to %s and %s"),
 506                                                    key2str(cp[i].keys[j]),
 507                                                    get_key_command_name(cp[i].command),
 508                                                    get_key_command_name(cmd));
 509                                 } else {
 510                                         fprintf(stderr,
 511                                                 _("Key %s assigned to %s and %s"),
 512                                                 key2str(cp[i].keys[j]),
 513                                                 get_key_command_name(cp[i].command),
 514                                                 get_key_command_name(cmd));
 515                                         fputc('\n', stderr);
 516                                 }
 517                                 cp[i].flags |= COMMAND_KEY_CONFLICT;
 518                                 set_key_flags(cp, cmd, COMMAND_KEY_CONFLICT);
 519                                 retval = -1;
 520                         }
 521                 }
 522         }
 523
 524         return retval;
 525 }
 526
 527 int
 528 write_key_bindings(FILE *f, int flags)
 529 {
 530         int i = 0, j;
 531
 532         if (flags & KEYDEF_WRITE_HEADER)
 533                 fprintf(f, "## Key bindings for ncmpc (generated by ncmpc)\n\n");
 534
 535         while (cmds[i].name && !ferror(f)) {
 536                 if (cmds[i].flags & COMMAND_KEY_MODIFIED ||
 537                     flags & KEYDEF_WRITE_ALL) {
 538                         fprintf(f, "## %s\n", cmds[i].description);
 539                         if (flags & KEYDEF_COMMENT_ALL)
 540                                 fprintf(f, "#");
 541                         fprintf(f, "key %s = ", cmds[i].name);
 542                         for (j = 0; j < MAX_COMMAND_KEYS; j++) {
 543                                 if (j && cmds[i].keys[j])
 544                                         fprintf(f, ",  ");
 545                                 if (!j || cmds[i].keys[j]) {
 546                                         if (cmds[i].keys[j]<256 && (isalpha(cmds[i].keys[j]) ||
 547                                                                     isdigit(cmds[i].keys[j])))
 548                                                 fprintf(f, "\'%c\'", cmds[i].keys[j]);
 549                                         else
 550                                                 fprintf(f, "%d", cmds[i].keys[j]);
 551                                 }
 552                         }
 553                         fprintf(f,"\n\n");
 554                 }
 555                 i++;
 556         }
 557
 558         return ferror(f);
 559 }
 560
 561 #endif