Archive for the ‘Tools’ Category
Kindle
I bought a basic Kindle recently and I’m enjoying it. I don’t currently plan to buy many e-books, but rather use the Kindle as a better tool for existing reading compared to my computer and phone. Here’s what I’ve discovered so far:
PDFs
I’ve found a number of free books in PDF form that I plan to work through:
- A number of books and articles by James Jordan are available at Biblical Horizons. Through New Eyes is a great introduction to Jordan’s work if you are unfamiliar with him.
- Gary North has a number of books available for free. At a minimum, right now I plan to work through some of the books by North, David Chilton, Ken Gentry and George Grant.
- There are a number of free books available at the von Mises Institute. Bruno Leoni’s Freedom and the Law in particular comes highly recommended, and I’ve just finished Henry Hazlitt’s outstanding Economics in One Lesson.
There are also lots of books available at Project Gutenberg and the Christian Classics Ethereal Library.
PDF’s aren’t the best format for reading on Kindle. I’ve found two tools for converting PDFs to e-books and uploading them to my Kindle. For simple PDFs (e.g., single column, and not a scanned image), Calibre is great for converting and uploading. However, Calibre does a poor job with PDFs that are scanned copies of books (this applies to many of the books linked above). For these I use a two-step process: first, I run the PDF through the K2PDFOpt tool (at the time of this writing, version 1.63 crashes for me on some books, but 1.51 is stable). This increases the size of the PDF file significantly, but it organizes it in a form that Calibre is much better able to handle. Then I use Calibre to convert these PDFs to e-books, and upload them to my Kindle.
Articles
Until now, I saved longer articles and blog posts for later reading using open tabs in my browser. This quickly grows unwieldy. The Instapaper service allows you to save web pages for later reading, and it integrates with Kindle. Now when I run across a longer article, I click a button to send it to Instapaper, and by the next morning the article is ready to read on my Kindle.
Blogs
The Kindlefeeder service allows you to send blog and news feeds to your Kindle. I’ve selected several of the blogs I read (ones that tend to have longer articles) to be sent to my Kindle, and now I read them there rather than on my computer.
Other
If you have any other tips and tricks I’d appreciate hearing about them.
All of the above should work with e-readers other than Kindle. In the case of Instapaper and Kindlefeeder, you may need to upload a file manually to your reader instead of having it automatically sent there.
SmugMug uploader
I’ve written a small Python script to upload pictures to a SmugMug gallery. I love SmugMug and use it extensively for family photos. I’m using this script for my personal use because it’s much simpler and much less of a resource hog than a browser-based uploader, and also because it was a fun exercise to try out the SmugMug API. You can run this script as follows to upload one or more files:
python upload.py gallery-name picture-file-name . . .
On Windows I’ve set up a desktop shortcut pointing to the script, and I can drag and drop a pile of picture files onto the icon and it will upload away. I’ve tested it using both Python 2.5 using simplejson, and also using Python 2.6 which has simplejson built in. Earlier versions of Python may require you to change the import of hashlib to md5, and change the hashlib.md5() invocation to a md5.new() invocation. You’ll also need to modify the script to contain your email address and SmugMug password, and obtain a SmugMug API key for your own development use, but this is a very painless process. Here is the script:
#!/usr/bin/python ########## # Requirements: Python 2.6 or # simplejson from http://pypi.python.org/pypi/simplejson ########## EMAIL='...' PASSWORD='...' ########## APIKEY='...' API_VERSION='1.2.2' API_URL='https://api.smugmug.com/services/api/json/1.2.2/' UPLOAD_URL='http://upload.smugmug.com/photos/xmlrawadd.mg' import sys, re, urllib, urllib2, urlparse, hashlib, traceback, os.path try : import json except : import simplejson as json if len(sys.argv) < 3 : print 'Usage:' print ' upload.py album picture1 [picture2 [...]]' print sys.exit(0) album_name = sys.argv[1] su_cookie = None def safe_geturl(request) : global su_cookie # Try up to three times for x in range(5) : try : response_obj = urllib2.urlopen(request) response = response_obj.read() result = json.loads(response) # Test for presence of _su cookie and consume it meta_info = response_obj.info() if meta_info.has_key('set-cookie') : match = re.search('(_su=\S+);', meta_info['set-cookie']) if match and match.group(1) != "_su=deleted" : su_cookie = match.group(1) if result['stat'] != 'ok' : raise Exception('Bad result code') return result except : if x < 4 : print " ... failed, retrying" else : print " ... failed, giving up" print " Request was:" print " " + request.get_full_url() try : print " Response was:" print response except : pass traceback.print_exc() #sys.stdin.readline() #sys.exit(1) return result def smugmug_request(method, params) : global su_cookie paramstrings = [urllib.quote(key)+'='+urllib.quote(params[key]) for key in params] paramstrings += ['method=' + method] url = urlparse.urljoin(API_URL, '?' + '&'.join(paramstrings)) request = urllib2.Request(url) if su_cookie : request.add_header('Cookie', su_cookie) return safe_geturl(request) result = smugmug_request('smugmug.login.withPassword', {'APIKey' : APIKEY, 'EmailAddress' : EMAIL, 'Password' : PASSWORD}) session = result['Login']['Session']['id'] result = smugmug_request('smugmug.albums.get', {'SessionID' : session}) album_id = None for album in result['Albums'] : if album['Title'] == album_name : album_id = album['id'] break if album_id is None : print 'That album does not exist' sys.exit(1) for filename in sys.argv[2:] : data = open(filename, 'rb').read() print 'Uploading ' + filename upload_request = urllib2.Request(UPLOAD_URL, data, {'Content-Length' : len(data), 'Content-MD5' : hashlib.md5(data).hexdigest(), 'Content-Type' : 'none', 'X-Smug-SessionID': session, 'X-Smug-Version' : API_VERSION, 'X-Smug-ResponseType' : 'JSON', 'X-Smug-AlbumID' : album_id, 'X-Smug-FileName' : os.path.basename(filename) }) result = safe_geturl(upload_request) if result['stat'] == 'ok' : print " ... successful" print 'Done' # sys.stdin.readline()
I am donating this script to the public domain. You are welcome to use and modify it as you please without conditions. I’d appreciate hearing about your experience with this script or any changes and improvements you’ve made; please leave a comment. Thanks!
Update 2010-07-20
Since I first posted this, I’ve updated it as follows:
- Add a Content-Type header of ‘none’. This is to workaround a bug in the SmugMug API.
- Use basename() to send only the file’s basename for X-Smug-FileName.
- Rewrite safe_geturl() to loop up to five times if the upload attempt fails. I’ve found that uploading is surprisingly unreliable, and re-attempting the upload generally works fine.
- Add a commented call to readline() at the end of the script. In my case, I run my script by dragging files onto an icon on my Windows desktop, which causes it to run in a DOS window and vanish when done. If you uncomment this line, it will wait for you to press Enter when it is done uploading. You’ll be able to see any files that weren’t uploaded successfully.
Update 2010-11-28
SmugMug made a recent change to their API’s login behavior which broke this script. While the new login behavior is not documented in the API docs, the fix is apparently to use a session cookie along with the session ID. While it’s a bit of a kludge, I’ve updated the script above to save this cookie in a global variable and submit it on subsequent requests.
Update 2011-06-24
I’ve fixed a bug in the script causing it to wrongly report a failure for certain requests that don’t send back the session cookie. The fix involves testing whether a set-cookie header was returned before accessing the header.
Update 2013-10-01
Version 1.2.0 of the SmugMug API has stopped working, so I have updated the script to use version 1.2.2 of the API.
Improving Firefox session restore
I use Firefox session restore regularly. This saves all my open tabs whenever Firefox closes (or crashes) and restores them when it reopens. Unfortunately, there are still cases where Firefox will forget my open tabs. This happens, for example, when I close my main window, thinking that I’m closing Firefox, but then I realize that there is still a pop-up window open. When I restart Firefox, that popup will be restored instead of my old tab list!
I have not yet found a way to recover the tabs. What a sinking feeling this leaves you with! My open tabs are sometimes the result of several weeks’ worth of browsing. I’ve grown better at saving links using del.icio.us rather than holding them in open tags, and obviously I need to work harder at this. But I often still have up to 20 tabs open at any given time, waiting to be read.
This happened to me again today. So I resolved one more time to try to find a solution. And I did! I found and installed Tab Mix Plus (I installed the latest TMP development build). This Firefox plugin remembers your sessions from more than just the most recently closed window. So if you close your main window first but find a popup lingering, you can close the popup without worrying that you have lost the tabs from your main window. What a relief!
Here are the settings that I chose in TMP:
- When you first enable Tab Mix Plus, it asks you whether you want to use the Firefox session restore feature. The TMP session restore is much better than Firefox’s, so choose No.
- Go to Tools|Tab Mix Plus Options to choose other options.
- Click the “Events” icon. On the “Tab Features” tab, un-check “Ctrl-Tab navigates tabs in the most recently used order.” This will set Ctrl+Tab to behave the way it usually does in Firefox.
- Click the “Session” icon.
- Make sure that “Use Firefox’s built-in Session Restore feature” is not checked.
- Under “When Browser Starts”, select “Restore”.
- Under “When Browser Exits”, make sure “Save Session” is selected.
Tab Mix Plus provides additional control over your browser sessions. Using the Tools|Session Manager menu, you can manually save sessions, and also restore older sessions.