1 #ifndef MPDCLIENT_H
2 #define MPDCLIENT_H
3 #include "libmpdclient.h"
5 #define MPD_VERSION_EQ(c,x,y,z) (c->connection->version[0] == x && \
6 c->connection->version[1] == y && \
7 c->connection->version[2] == z )
9 #define MPD_VERSION_LT(c,x,y,z) ( c->connection->version[0]<x || \
10 (c->connection->version[0]==x && c->connection->version[1]<y) || \
11 (c->connection->version[0]==x && c->connection->version[1]==y && \
12 c->connection->version[2]<z) )
16 /****************************************************************************/
17 /* Playlist */
18 /****************************************************************************/
20 typedef struct
21 {
22 /* playlist id */
23 long long id;
24 /* list length */
25 guint length;
26 /* true if the list is updated */
27 gboolean updated;
28 /* the list */
29 GList *list;
31 } mpdclient_playlist_t;
34 typedef struct
35 {
36 guint flags;
37 mpd_InfoEntity *entity;
38 } filelist_entry_t;
40 typedef struct
41 {
42 /* path */
43 gchar *path;
44 /* list length */
45 guint length;
46 /* true if the list is updated */
47 gboolean updated;
48 /* the list */
49 GList *list;
51 } mpdclient_filelist_t;
53 typedef struct
54 {
55 /* playlist */
56 mpdclient_playlist_t playlist;
58 /* Callbacks */
59 GList *error_callbacks;
60 GList *playlist_callbacks;
61 GList *browse_callbacks;
63 mpd_Connection *connection;
64 mpd_Status *status;
65 mpd_Song *song;
67 gboolean need_update;
69 } mpdclient_t;
71 /** functions ***************************************************************/
73 gint
74 mpdclient_finish_command(mpdclient_t *c);
76 mpdclient_t *mpdclient_new(void);
77 mpdclient_t *mpdclient_free(mpdclient_t *c);
78 gint mpdclient_connect(mpdclient_t *c, gchar *host, gint port,
79 gfloat timeout, gchar *password);
80 gint mpdclient_disconnect(mpdclient_t *c);
81 gint mpdclient_update(mpdclient_t *c);
84 /*** MPD Commands **********************************************************/
85 gint mpdclient_cmd_play(mpdclient_t *c, gint index);
86 gint mpdclient_cmd_pause(mpdclient_t *c, gint value);
87 gint mpdclient_cmd_stop(mpdclient_t *c);
88 gint mpdclient_cmd_next(mpdclient_t *c);
89 gint mpdclient_cmd_prev(mpdclient_t *c);
90 gint mpdclient_cmd_seek(mpdclient_t *c, gint id, gint pos);
91 gint mpdclient_cmd_shuffle(mpdclient_t *c);
92 gint mpdclient_cmd_clear(mpdclient_t *c);
93 gint mpdclient_cmd_repeat(mpdclient_t *c, gint value);
94 gint mpdclient_cmd_random(mpdclient_t *c, gint value);
95 gint mpdclient_cmd_crossfade(mpdclient_t *c, gint value);
96 gint mpdclient_cmd_db_update_utf8(mpdclient_t *c, gchar *path);
97 gint mpdclient_cmd_volume(mpdclient_t *c, gint value);
98 gint mpdclient_cmd_add_path(mpdclient_t *c, gchar *path);
99 gint mpdclient_cmd_add_path_utf8(mpdclient_t *c, gchar *path);
101 gint mpdclient_cmd_add(mpdclient_t *c, mpd_Song *song);
102 gint mpdclient_cmd_delete(mpdclient_t *c, gint index);
103 gint mpdclient_cmd_move(mpdclient_t *c, gint old_index, gint new_index);
105 gint mpdclient_cmd_save_playlist(mpdclient_t *c, gchar *filename);
106 gint mpdclient_cmd_save_playlist_utf8(mpdclient_t *c, gchar *filename);
107 gint mpdclient_cmd_load_playlist_utf8(mpdclient_t *c, gchar *filename_utf8);
108 gint mpdclient_cmd_delete_playlist(mpdclient_t *c, gchar *filename);
109 gint mpdclient_cmd_delete_playlist_utf8(mpdclient_t *c, gchar *filename_utf8);
111 /* list functions */
112 GList *mpdclient_get_artists_utf8(mpdclient_t *c);
113 GList *mpdclient_get_albums_utf8(mpdclient_t *c, gchar *artist_utf8);
116 /*** error callbacks *****************************************************/
118 #define IS_ACK_ERROR(n) (n & MPD_ERROR_ACK)
119 #define GET_ACK_ERROR_CODE(n) ((n & 0xFF00) >> 8)
121 typedef void (*mpdc_error_cb_t) (mpdclient_t *c, gint error, const gchar *msg);
123 void mpdclient_install_error_callback(mpdclient_t *c, mpdc_error_cb_t cb);
124 void mpdclient_remove_error_callback(mpdclient_t *c, mpdc_error_cb_t cb);
126 /*** playlist functions **************************************************/
128 /* free a playlist */
129 gint mpdclient_playlist_free(mpdclient_playlist_t *playlist);
130 /* update the complete playlist */
131 gint mpdclient_playlist_update(mpdclient_t *c);
132 /* get playlist changes */
133 gint mpdclient_playlist_update_changes(mpdclient_t *c);
135 GList *playlist_lookup(mpdclient_t *c, gint id);
136 mpd_Song *playlist_lookup_song(mpdclient_t *c, gint id);
137 mpd_Song *playlist_get_song(mpdclient_t *c, gint index);
138 gint playlist_get_index(mpdclient_t *c, mpd_Song *song);
139 gint playlist_get_index_from_id(mpdclient_t *c, gint id);
140 gint playlist_get_index_from_file(mpdclient_t *c, gchar *filename);
144 /*** mpdclient playlist callbacks *****************************************/
146 #define PLAYLIST_EVENT_UPDATED 0x01
147 #define PLAYLIST_EVENT_CLEAR 0x02
148 #define PLAYLIST_EVENT_DELETE 0x03
149 #define PLAYLIST_EVENT_ADD 0x04
150 #define PLAYLIST_EVENT_MOVE 0x05
153 typedef void (*mpdc_list_cb_t) (mpdclient_t *c, int event, gpointer data);
155 /* install a playlist callback function */
156 void mpdclient_install_playlist_callback(mpdclient_t *c, mpdc_list_cb_t cb);
158 /* remove a playlist callback function */
159 void mpdclient_remove_playlist_callback(mpdclient_t *c, mpdc_list_cb_t cb);
162 /* issue a playlist callback */
163 void mpdclient_playlist_callback(mpdclient_t *c, int event, gpointer data);
166 /*** filelist functions ***************************************************/
167 mpdclient_filelist_t *mpdclient_filelist_free(mpdclient_filelist_t *filelist);
168 mpdclient_filelist_t *mpdclient_filelist_get(mpdclient_t *c, const gchar *path);
169 mpdclient_filelist_t *mpdclient_filelist_search(mpdclient_t *c,
170 int exact_match,
171 int table,
172 gchar *path);
173 mpdclient_filelist_t *mpdclient_filelist_search_utf8(mpdclient_t *c,
174 int exact_match,
175 int table,
176 gchar *path);
177 mpdclient_filelist_t *mpdclient_filelist_update(mpdclient_t *c,
178 mpdclient_filelist_t *flist);
180 #define HIGHLIGHT (0x01)
181 void mpdclient_filelist_set_flags(mpdclient_filelist_t *flist,
182 mpd_Song *song,
183 guint flags);
185 void mpdclient_filelist_clear_flags(mpdclient_filelist_t *flist);
186 void mpdclient_filelist_clear_flags(mpdclient_filelist_t *flist);
187 filelist_entry_t *mpdclient_filelist_find_song(mpdclient_filelist_t *flist,
188 mpd_Song *song);
190 /* add all songs in filelist to the playlist */
191 int mpdclient_filelist_add_all(mpdclient_t *c, mpdclient_filelist_t *fl);
193 /*** mpdclient browse callbacks ********************************************/
195 #define BROWSE_DB_UPDATED 0x01
196 #define BROWSE_PLAYLIST_SAVED 0x02
197 #define BROWSE_PLAYLIST_DELETED 0x03
200 /* install a playlist callback function */
201 void mpdclient_install_browse_callback(mpdclient_t *c, mpdc_list_cb_t cb);
203 /* remove a playlist callback function */
204 void mpdclient_remove_browse_callback(mpdclient_t *c, mpdc_list_cb_t cb);
207 /* issue a playlist callback */
208 void mpdclient_browse_callback(mpdclient_t *c, int event, gpointer data);
210 /* sort by list-format */
211 gint compare_filelistentry_format(gconstpointer filelist_entry1, gconstpointer filelist_entry2);
213 #endif