mac-slideshow 2018.11.19

MacOS slideshow screensaver

Install

$ [sudo] pip install mac-slideshow

Functions

function	description
mac_slideshow.enable()	enable iLifeSlideshow screensaver
mac_slideshow.enabled()	return True if iLifeSlideshow screensaver enabled
mac_slideshow.pid()	return ScreenSaverEngine.app pid
mac_slideshow.restart(path=None)	restart screensaver and return screensaver pid
mac_slideshow.start(path=None)	start screensaver and return screensaver pid
mac_slideshow.stop()	stop screensaver
mac_slideshow.path.read()	return iLifeSlideShows images folder path
mac_slideshow.path.write(path)	write iLifeSlideShows images folder path
mac_slideshow.preferences.read(key)	return preferences value
mac_slideshow.preferences.write(key, value)	write preferences value
mac_slideshow.style.read()	return iLifeSlideShows style
mac_slideshow.style.write(style)	write iLifeSlideShows style

CLI

usage	description
python -m mac_slideshow.path [path]	read/write iLifeSlideShows screensaver path
python -m mac_slideshow.pid	print screensaver pid
python -m mac_slideshow.start [path]	start iLifeSlideshows screensaver
python -m mac_slideshow.stop	stop iLifeSlideshows screensaver
python -m mac_slideshow.style [style]	read/write iLifeSlideShows screensaver style

Examples

>>> import mac_slideshow
>>> mac_slideshow.start()  # start and return screensaver pid
1234
>>> mac_slideshow.restart()  # restart with new pid
1240
>>> mac_slideshow.pid()
1240
>>> mac_slideshow.stop()

start/restart with path

>>> mac_slideshow.start("~/Library/Screen Savers/folder")

preferences

>>> mac_slideshow.path.write("path/to/images")
>>> mac_slideshow.path.read()
'path/to/images'

>>> mac_slideshow.style.write("Classic")
>>> mac_slideshow.style.read()
'Classic'

readme-md - README.md generator