src/mpdclient.h

   1 #ifndef MPDCLIENT_H
   2 #define MPDCLIENT_H
   3
   4 #include "libmpdclient.h"
   5 #include "playlist.h"
   6 #include "filelist.h"
   7
   8 #define MPD_VERSION_EQ(c,x,y,z) (c->connection->version[0] == x && \
   9                                  c->connection->version[1] == y && \
  10                                  c->connection->version[2] == z )
  11
  12 #define MPD_VERSION_LT(c,x,y,z) ( c->connection->version[0]<x  || \
  13  (c->connection->version[0]==x && c->connection->version[1]<y) || \
  14  (c->connection->version[0]==x && c->connection->version[1]==y && \
  15   c->connection->version[2]<z) )
  16
  17 typedef struct mpdclient {
  18         /* playlist */
  19         mpdclient_playlist_t playlist;
  20
  21         /* Callbacks */
  22         GList *error_callbacks;
  23         GList *playlist_callbacks;
  24         GList *browse_callbacks;
  25
  26         mpd_Connection *connection;
  27         mpd_Status     *status;
  28         mpd_Song       *song;
  29
  30         gboolean       need_update;
  31 } mpdclient_t;
  32
  33 /** functions ***************************************************************/
  34
  35 gint
  36 mpdclient_finish_command(mpdclient_t *c);
  37
  38 mpdclient_t *mpdclient_new(void);
  39 void mpdclient_free(mpdclient_t *c);
  40 gint mpdclient_connect(mpdclient_t *c, gchar *host, gint port,
  41                        gfloat timeout, gchar *password);
  42 gint mpdclient_disconnect(mpdclient_t *c);
  43 gint mpdclient_update(mpdclient_t *c);
  44
  45
  46 /*** MPD Commands  **********************************************************/
  47 gint mpdclient_cmd_play(mpdclient_t *c, gint index);
  48 gint mpdclient_cmd_pause(mpdclient_t *c, gint value);
  49 gint mpdclient_cmd_stop(mpdclient_t *c);
  50 gint mpdclient_cmd_next(mpdclient_t *c);
  51 gint mpdclient_cmd_prev(mpdclient_t *c);
  52 gint mpdclient_cmd_seek(mpdclient_t *c, gint id, gint pos);
  53 gint mpdclient_cmd_shuffle(mpdclient_t *c);
  54 gint mpdclient_cmd_clear(mpdclient_t *c);
  55 gint mpdclient_cmd_repeat(mpdclient_t *c, gint value);
  56 gint mpdclient_cmd_random(mpdclient_t *c, gint value);
  57 gint mpdclient_cmd_crossfade(mpdclient_t *c, gint value);
  58 gint mpdclient_cmd_db_update_utf8(mpdclient_t *c, gchar *path);
  59 gint mpdclient_cmd_volume(mpdclient_t *c, gint value);
  60 gint mpdclient_cmd_add_path(mpdclient_t *c, gchar *path);
  61 gint mpdclient_cmd_add_path_utf8(mpdclient_t *c, gchar *path);
  62
  63 gint mpdclient_cmd_add(mpdclient_t *c, struct mpd_song *song);
  64 gint mpdclient_cmd_delete(mpdclient_t *c, gint index);
  65 gint mpdclient_cmd_move(mpdclient_t *c, gint old_index, gint new_index);
  66
  67 gint mpdclient_cmd_save_playlist(mpdclient_t *c, gchar *filename);
  68 gint mpdclient_cmd_save_playlist_utf8(mpdclient_t *c, gchar *filename);
  69 gint mpdclient_cmd_load_playlist_utf8(mpdclient_t *c, gchar *filename_utf8);
  70 gint mpdclient_cmd_delete_playlist(mpdclient_t *c, gchar *filename);
  71 gint mpdclient_cmd_delete_playlist_utf8(mpdclient_t *c, gchar *filename_utf8);
  72
  73 /* list functions */
  74 GList *mpdclient_get_artists_utf8(mpdclient_t *c);
  75 GList *mpdclient_get_albums_utf8(mpdclient_t *c, gchar *artist_utf8);
  76
  77
  78 /*** error callbacks *****************************************************/
  79
  80 #define IS_ACK_ERROR(n)       (n & MPD_ERROR_ACK)
  81 #define GET_ACK_ERROR_CODE(n) ((n & 0xFF00) >> 8)
  82
  83 typedef void (*mpdc_error_cb_t) (mpdclient_t *c, gint error, const gchar *msg);
  84
  85 void mpdclient_install_error_callback(mpdclient_t *c, mpdc_error_cb_t cb);
  86 void mpdclient_remove_error_callback(mpdclient_t *c, mpdc_error_cb_t cb);
  87
  88 /*** playlist functions  **************************************************/
  89
  90 /* update the complete playlist */
  91 gint mpdclient_playlist_update(struct mpdclient *c);
  92
  93 /* get playlist changes */
  94 gint mpdclient_playlist_update_changes(struct mpdclient *c);
  95
  96
  97 /*** mpdclient playlist callbacks *****************************************/
  98
  99 #define PLAYLIST_EVENT_UPDATED     0x01
 100 #define PLAYLIST_EVENT_CLEAR       0x02
 101 #define PLAYLIST_EVENT_DELETE      0x03
 102 #define PLAYLIST_EVENT_ADD         0x04
 103 #define PLAYLIST_EVENT_MOVE        0x05
 104
 105
 106 typedef void (*mpdc_list_cb_t) (mpdclient_t *c, int event, gpointer data);
 107
 108 /* install a playlist callback function */
 109 void mpdclient_install_playlist_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 110
 111 /* remove a playlist callback function */
 112 void mpdclient_remove_playlist_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 113
 114
 115 /* issue a playlist callback */
 116 void mpdclient_playlist_callback(mpdclient_t *c, int event, gpointer data);
 117
 118
 119 /*** filelist functions  ***************************************************/
 120
 121 mpdclient_filelist_t *mpdclient_filelist_get(mpdclient_t *c, const gchar *path);
 122 mpdclient_filelist_t *mpdclient_filelist_search(mpdclient_t *c,
 123                                                 int exact_match,
 124                                                 int table,
 125                                                 gchar *path);
 126 mpdclient_filelist_t *mpdclient_filelist_search_utf8(mpdclient_t *c,
 127                                                      int exact_match,
 128                                                      int table,
 129                                                      gchar *path);
 130 mpdclient_filelist_t *mpdclient_filelist_update(mpdclient_t *c,
 131                                                 mpdclient_filelist_t *flist);
 132
 133 /* add all songs in filelist to the playlist */
 134 int mpdclient_filelist_add_all(mpdclient_t *c, mpdclient_filelist_t *fl);
 135
 136 /*** mpdclient browse callbacks ********************************************/
 137
 138 #define BROWSE_DB_UPDATED          0x01
 139 #define BROWSE_PLAYLIST_SAVED      0x02
 140 #define BROWSE_PLAYLIST_DELETED    0x03
 141
 142
 143 /* install a playlist callback function */
 144 void mpdclient_install_browse_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 145
 146 /* remove a playlist callback function */
 147 void mpdclient_remove_browse_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 148
 149
 150 /* issue a playlist callback */
 151 void mpdclient_browse_callback(mpdclient_t *c, int event, gpointer data);
 152
 153 /* sort by list-format */
 154 gint compare_filelistentry_format(gconstpointer filelist_entry1, gconstpointer filelist_entry2);
 155
 156 #endif