rename runProgram
[bg-scripts] / randombg.py
1 #!/usr/bin/env python
2
3 VERSION = "2.1"
4
5
6 import asyncore
7 import asynchat
8 import socket
9 import os
10 import random
11 import sys
12 import time
13 from optparse import OptionParser
14 import logging
15 try:
16 logging.basicConfig(format="%(levelname)s: %(message)s")
17 except TypeError:
18 # Python 2.3's logging.basicConfig does not support parameters
19 logging.basicConfig()
20
21 try:
22 import cPickle as pickle
23 except ImportError:
24 import pickle
25
26 try:
27 # Required libraries
28 import asyncsched
29 import wallchanger
30 except ImportError, e:
31 logging.critical("Missing libraries! Exiting...", exc_info=1)
32 sys.exit(1)
33
34
35
36
37 def filter_images(filenames):
38 extensions = ('.jpg', '.jpe', '.jpeg', '.png', '.gif', '.bmp')
39 for filename in filenames:
40 _, ext = os.path.splitext(filename)
41 if ext.lower() in extensions:
42 yield filename
43
44 class BaseFileList(object):
45 """Base file list implementation"""
46 def __init__(self):
47 self.paths = []
48 self.favourites = []
49
50 def add_path(self, path):
51 self.paths.append(path)
52
53 def store_cache(self, filename):
54 try:
55 logging.debug("Attempting to store cache")
56 fd = open(filename, 'wb')
57 pickle.dump(self, fd, 2)
58 logging.debug("Cache successfully stored")
59 except Exception, e:
60 warning("Storing cache: %s" % e)
61
62 def load_cache(self, filename):
63 try:
64 logging.debug("Attempting to load cache from: %s" % filename)
65 self.paths.sort()
66
67 fd = open(filename, 'rb')
68 tmp = pickle.load(fd)
69
70 if tmp.__class__ != self.__class__:
71 raise ValueError("Using different file list type")
72
73 tmp.paths.sort()
74 if self.paths != tmp.paths:
75 raise ValueError, "Path list changed"
76
77 # Overwrite this object with the other
78 for attr, value in tmp.__dict__.items():
79 setattr(self, attr, value)
80
81 return True
82
83 except Exception, e:
84 logging.warning("Loading cache: %s" % e)
85 return False
86
87 def add_to_favourites(self):
88 '''Adds the current image to the list of favourites'''
89 self.favourites.append(self.get_current_image())
90
91 def scan_paths(self):
92 raise NotImplementedError()
93
94 def get_next_image(self):
95 raise NotImplementedError()
96
97 def get_prev_image(self):
98 raise NotImplementedError()
99
100 def get_current_image(self):
101 raise NotImplementedError()
102
103 def is_empty(self):
104 return True
105
106
107 class RandomFileList(BaseFileList):
108 def __init__(self):
109 super(RandomFileList, self).__init__()
110 self.list = []
111 self.last_image = None
112
113 def scan_paths(self):
114 for path in self.paths:
115 for dirpath, dirsnames, filenames in os.walk(path):
116 for filename in filter_images(filenames):
117 self.list.append(os.path.join(dirpath, filename))
118
119 def add_path(self, path):
120 self.paths.append(path)
121 logging.debug('Added path "%s" to the list' % path)
122
123 def get_next_image(self):
124 n = random.randint(0, len(self.list)-1)
125 self.last_image = self.list[n]
126 logging.debug("Picked file '%s' from list" % self.last_image)
127 return self.last_image
128
129 def get_current_image(self):
130 if self.last_image:
131 return self.last_image
132 else:
133 return self.get_next_image()
134
135 def is_empty(self):
136 return len(self.list) == 0
137
138
139 class AllRandomFileList(BaseFileList):
140 def __init__(self):
141 super(AllRandomFileList, self).__init__()
142 self.list = None
143 self.imagePointer = 0
144
145 # Scan the input directory, and then randomize the file list
146 def scan_paths(self):
147 logging.debug("Scanning paths")
148
149 self.list = []
150 for path in self.paths:
151 logging.debug('Scanning "%s"' % path)
152 for dirpath, dirsnames, filenames in os.walk(path):
153 for filename in filter_images(filenames):
154 logging.debug('Adding file "%s"' % filename)
155 self.list.append(os.path.join(dirpath, filename))
156
157 random.shuffle(self.list)
158
159 def add_path(self, path):
160 self.paths.append(path)
161 logging.debug('Added path "%s" to the list' % path)
162
163 def store_cache(self, filename):
164 try:
165 fd = open(filename, 'wb')
166 pickle.dump(self, fd, 2)
167 logging.debug("Cache successfully stored")
168 except Exception, e:
169 logging.warning("Storing cache", exc_info=1)
170
171 def get_current_image(self):
172 return self.list[self.imagePointer]
173
174 def __inc_in_range(self, n, amount = 1, rangeMax = None, rangeMin = 0):
175 if rangeMax == None: rangeMax = len(self.list)
176 assert rangeMax > 0
177 return (n + amount) % rangeMax
178
179 def get_next_image(self):
180 self.imagePointer = self.__inc_in_range(self.imagePointer)
181 imageName = self.list[self.imagePointer]
182 logging.debug("Picked file '%s' (pointer=%d) from list" % (imageName, self.imagePointer))
183 return imageName
184
185 def get_prev_image(self):
186 self.imagePointer = self.__inc_in_range(self.imagePointer, amount=-1)
187 imageName = self.list[self.imagePointer]
188 logging.debug("Picked file '%s' (pointer=%d) from list" % (imageName, self.imagePointer))
189 return imageName
190
191 def is_empty(self):
192 return len(self.list) == 0
193
194
195 class FolderRandomFileList(BaseFileList):
196 """A file list that will pick a file randomly within a directory. Each
197 directory has the same chance of being chosen."""
198 def __init__(self):
199 super(FolderRandomFileList, self).__init__()
200 self.directories = {}
201 self.last_image = None
202
203 def scan_paths(self):
204 pass
205
206 def add_path(self, path):
207 logging.debug('Added path "%s" to the list' % path)
208 for dirpath, dirs, filenames in os.walk(path):
209 logging.debug('Scanning "%s" for images' % dirpath)
210 if self.directories.has_key(dirpath):
211 continue
212 filenames = list(filter_images(filenames))
213 if len(filenames):
214 self.directories[dirpath] = filenames
215 logging.debug('Adding "%s" to "%s"' % (filenames, dirpath))
216 else:
217 logging.debug("No images found in '%s'" % dirpath)
218
219 def get_next_image(self):
220 directory = random.choice(self.directories.keys())
221 logging.debug('directory: "%s"' % directory)
222 filename = random.choice(self.directories[directory])
223 logging.debug('filename: "%s"' % filename)
224 return os.path.join(directory, filename)
225
226 def get_current_image(self):
227 if self.last_image:
228 return self.last_image
229 else:
230 return self.get_next_image()
231
232 def is_empty(self):
233 return len(self.directories.values()) == 0
234
235
236 class Cycler(object):
237 def init(self, options, paths, oneshot=False):
238 self.cycle_time = options.cycle_time
239 self.cache_filename = options.cache_filename
240
241 logging.debug("Initialising wallchanger")
242 wallchanger.init(options.background_colour, options.permanent, options.convert)
243
244 logging.debug("Initialising file list")
245 if options.all_random:
246 self.filelist = AllRandomFileList()
247 elif options.folder_random:
248 self.filelist = FolderRandomFileList()
249 else:
250 self.filelist = RandomFileList()
251
252 for path in paths:
253 self.filelist.add_path(path)
254
255 if self.filelist.load_cache(self.cache_filename):
256 logging.debug("Loaded cache successfully")
257 else:
258 logging.debug("Could not load cache")
259 self.filelist.scan_paths()
260
261 if self.filelist.is_empty():
262 logging.error("No images were found. Exiting...")
263 sys.exit(1)
264
265 self.task = None
266 if oneshot:
267 self.cmd_next()
268 else:
269 self.cmd_reload()
270
271 def finish(self):
272 self.filelist.store_cache(self.cache_filename)
273
274 def find_files(self, options, paths):
275 return filelist
276
277 def cmd_reset(self):
278 def next():
279 image = self.filelist.get_next_image()
280 wallchanger.set_image(image)
281 self.task = None
282 self.cmd_reset()
283
284 if self.task is not None:
285 self.task.cancel()
286 self.task = asyncsched.schedule(self.cycle_time, next)
287 logging.debug("Reset timer for %s seconds" % self.cycle_time)
288 self.filelist.store_cache(self.cache_filename)
289
290 def cmd_reload(self):
291 image = self.filelist.get_current_image()
292 wallchanger.set_image(image)
293 self.cmd_reset()
294
295 def cmd_next(self):
296 image = self.filelist.get_next_image()
297 wallchanger.set_image(image)
298 self.cmd_reset()
299
300 def cmd_prev(self):
301 image = self.filelist.get_prev_image()
302 wallchanger.set_image(image)
303 self.cmd_reset()
304
305 def cmd_rescan(self):
306 self.filelist.scan_paths()
307
308 def cmd_pause(self):
309 if self.task is not None:
310 self.task.cancel()
311 self.task = None
312
313 def cmd_exit(self):
314 asyncsched.exit()
315
316 def cmd_favourite(self):
317 self.filelist.add_to_favourites()
318
319 class Server(asynchat.async_chat):
320 def __init__(self, cycler, sock):
321 asynchat.async_chat.__init__(self, sock)
322 self.cycler = cycler
323 self.ibuffer = []
324 self.set_terminator("\n")
325
326 def collect_incoming_data(self, data):
327 self.ibuffer.append(data)
328
329 def found_terminator(self):
330 line = "".join(self.ibuffer).lower()
331 self.ibuffer = []
332 prefix, cmd = line.split(None, 1)
333 if prefix != "cmd":
334 logging.debug('Bad line received "%s"' % line)
335 return
336 if hasattr(self.cycler, "cmd_" + cmd):
337 logging.debug('Executing command "%s"' % cmd)
338 getattr(self.cycler, "cmd_" + cmd)()
339 else:
340 logging.debug('Unknown command received "%s"' % cmd)
341
342
343 class SockHackWrap(object):
344 def __init__(self, sock, addr):
345 self.__sock = sock
346 self.__addr = addr
347 def getpeername(self):
348 return self.__addr
349 def __getattr__(self, key):
350 return getattr(self.__sock, key)
351
352 class Listener(asyncore.dispatcher):
353 def __init__(self, socket_filename, cycler):
354 asyncore.dispatcher.__init__(self)
355 self.cycler = cycler
356 self.create_socket(socket.AF_UNIX, socket.SOCK_STREAM)
357 self.bind(socket_filename)
358 self.listen(2) # Backlog = 2
359
360 def handle_accept(self):
361 sock, addr = self.accept()
362 Server(self.cycler, SockHackWrap(sock, addr))
363
364 def writable(self):
365 return False
366
367
368 def do_server(options, paths):
369 try:
370 sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
371 sock.connect(options.socket_filename)
372 print >>sys.stderr, "Server is already running! Will do nothing"
373 return
374 except:
375 pass
376
377 try:
378 os.unlink(options.socket_filename)
379 except OSError:
380 pass
381
382 try:
383 cycler = Cycler()
384 listener = Listener(options.socket_filename, cycler)
385 # Initialisation of Cycler delayed so we grab the socket quickly
386 cycler.init(options, paths)
387 try:
388 asyncsched.loop()
389 except KeyboardInterrupt:
390 print
391 cycler.finish()
392 finally:
393 # Make sure that the socket is cleaned up
394 try:
395 os.unlink(options.socket_filename)
396 except OSError:
397 pass
398
399 def do_client(options, args):
400 if len(args) == 0:
401 args = ["next"]
402 sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
403 sock.connect(options.socket_filename)
404 sock = sock.makefile()
405 for i, cmd in enumerate(args):
406 sock.write("cmd %s\n" % cmd)
407 if i < len(args) - 1:
408 time.sleep(options.cycle_time)
409 sock.close()
410
411 def do_oneshot(options, paths):
412 cycler = Cycler()
413 cycler.init(options, paths, oneshot=True)
414
415 def build_parser():
416 parser = OptionParser(version="%prog " + VERSION,
417 description = "Cycles through random background images.",
418 usage =
419 "\n(server) %prog [options] dir [dir2 ...]"
420 "\n(client) %prog [options] [next|prev|rescan|reload|pause] [...]"
421 "\nThe first instance to be run will be the server.\n"
422 )
423 parser.add_option("-p", "--permanent",
424 action="store_true", dest="permanent", default=False,
425 help="Make the background permanent. Note: This will cause all machines logged in with this account to simultaneously change background [Default: %default]")
426 parser.add_option("-v", '-d', "--verbose", "--debug",
427 action="count", dest="verbose", default=0,
428 help="Make the louder (good for debugging, or those who are curious)")
429 parser.add_option("-b", "--background-colour",
430 action="store", type="string", dest="background_colour", default="black",
431 help="Change the default background colour that is displayed if the image is not in the correct aspect ratio [Default: %default]")
432 parser.add_option("--all-random",
433 action="store_true", dest="all_random", default=False,
434 help="Make sure that all images have been displayed before repeating an image")
435 parser.add_option("-1", "--oneshot",
436 action="store_true", dest="oneshot", default=False,
437 help="Set one random image and terminate immediately.")
438 parser.add_option("--folder-random",
439 action="store_true", dest="folder_random", default=False,
440 help="Give each folder an equal chance of having an image selected from it")
441 parser.add_option("--convert",
442 action="store_true", dest="convert", default=False,
443 help="Do conversions using ImageMagick or PIL, don't rely on the window manager")
444 parser.add_option("--cycle-time",
445 action="store", type="int", default=1800, dest="cycle_time",
446 help="Cause the image to cycle every X seconds")
447 parser.add_option("--socket",
448 action="store", type="string", dest="socket_filename", default=os.path.expanduser('~/.randombg_socket'),
449 help="Location of the command/control socket.")
450 parser.add_option("--cache-file",
451 action="store", type="string", dest="cache_filename", default=os.path.expanduser('~/.randombg_cache'),
452 help="Stores the location of the last image to be loaded.")
453 parser.add_option("--server",
454 action="store_true", dest="server", default=False,
455 help="Run in server mode to listen for clients.")
456 return parser
457
458 def main():
459 parser = build_parser()
460 options, args = parser.parse_args(sys.argv[1:])
461
462 if options.verbose == 1:
463 logging.getLogger().setLevel(logging.INFO)
464 elif options.verbose >= 2:
465 logging.getLogger().setLevel(logging.DEBUG)
466
467 if options.server:
468 do_server(options, args)
469 return
470
471 if options.oneshot:
472 do_oneshot(options, args)
473 return
474
475 try:
476 do_client(options, args)
477 return
478 except Exception, e:
479 print >>sys.stderr, "Failed to connect to server:", e
480
481
482 if __name__ == "__main__":
483 main()