BookSwap autorun book-file manager

[llasram]

Let’s call this an alpha release, but I’ve written a dead-simple filemanager for the Reader. It uses the same DOM/ECMAscript autorun functionality discovered and applied by igorsk, obelix, et al.

It provides the following capabilities:

1. Copy files between the Reader internal memory & SD card.
2. Move files between the internal memory & SD card.
3. Delete files from the internal memory & SD card.

With the following caveats:

1. I couldn’t manage to find any filesystem listing/transversal functions, although I imagine they’re probably there somewhere. This version thus limits itself to simple operations on the files found and cached by the Reader UI.
2. I haven’t figured out how to cause the Reader UI to re-scan the internal memory. This means the Reader won’t notice such changes until the next time you either reset it or just plug it in via USB. BookSwap re-scans memory on quit if any changes were made. This causes BookSwap to re-run, but quitting again will quit w/o the re-scan.
3. I haven’t tested this with a memory stick. It might work.
4. I have tested it with a both a PRS-500 and 505. On my 500 I can copy files off the SD card but copying to the card fails. However my 500 is damaged, so this may just be an artifact of the damage.

To install, just extract the attached archive into the root of an SD card.

Moderator: WARNING! Does not wotk with books you have in a collection

[gwynevans]

Nice - As you say, there are caveats but never-the-less, very nice!
--
Re 2: A full shutdown & restart also re-reads the internal memory, just in case you'd prefer ro avoid a reset.

Do you have any pointers to what functions, etc, have been discovered? Just wondering if there was any way of sorting the list of files somehow, for instance...
--
Just to say what I did - I was able to move a book to a SD card, reset it via USB to check it had gone, then copy it back from SD to Internal, reset it via shutdown/restart and read it again without the SD card.

[llasram]

Originally Posted by gwynevans

Re 2: A full shutdown & restart also re-reads the internal memory, just in case you'd prefer ro avoid a reset.

Good catch! I added an option to the main-menu to shutdown the Reader instead of just quit BookSwap and it works great. But unfortunately I didn’t bring the changes with me to work this morning and left my USB cable at home. I’ll upload a new version when I get home tonight.

Unrelatedly, I’ve noticed that I put this thread in the PRS-505–only category. As BookSwap does work on the PRS-500 it should probably go one level up... Am I just not seeing the interface to do that, or does one need to have moderator privileges to move threads around?

[llasram]

Originally Posted by gwynevans

Do you have any pointers to what functions, etc, have been discovered?

Like obelix pointed out in the thread for his Sudoku game, it's been pretty slap-and-dash. If you grab the contents of the Reader's /opt directory you'll get the whole UI. From there (for me anyway) it's been a matter of looking at the functions used in the existing XML files and running 'strings' on the binary files looking for likely candidates. I wrote a recursive object-dumper which was how I found the UI cache. I'll see about cleaning that up a bit and posting it.

It might be nice to start documenting some of this in the mobileread wiki. On the other hand, perhaps that hasn't been done so far because that gets pretty close to documenting the DRM-related functions...

Just wondering if there was any way of sorting the list of files somehow, for instance...

That would probably be possible, but I'd really like move to using the filesystem instead of the UI cache. Then users could arrange files into directories, making sorting less of an issue.

[llasram]

Uploaded version 0.1.1. Just modified the initial post to keep everything in the same place.

Changes:

• Implement real memory re-scanning.

[moneytoo]

Very nice and working.
I really missed some delete function on the Reader.

[gwynevans]

Originally Posted by llasram

Uploaded version 0.1.1.

My mods to 0.1.1.1 that you might want to have a look to see if there's anything useful, but most are 'personal preference' things...
Changes I tried are:

1. Changed "Quit" to "Quit with Restart" and added a "Quit" (without restart)
2. Added a 'List Books' (but it really needs as no-op function as you get an exception if you choose a book, as I reused ChooseFile).
3. Changed to display 'book.author + " - " + book.title rather than just title. (Personal pref, as it then matches the format I use for my filenames.)
4. Changed default location for SD cards to "Sony Reader/database/books/" (but no checks for missing folders) (Again, personal prefs)
5. Changed to use smaller, non-bold fonts for the label contents (more visible chars)
6. Added a 'books.sort()' (See comment below)
7. Added a version string in the XML
8. Added doFirst/doLast support for jumping by 10 pages (i.e. hold down next/prev)

--
Edit: Updated attatchment (to a 0.1.1.1-B version) as I realised what was wrong with my sorting & manged to add a routine to sort by Author, then Title. (This suits me, as I have my files as "<author> - <title>.lrf", but may not suit others, but it's at least there to change if wanted).

Moderator: WARNING! Does not wotk with books you have in a collection

[keith]

Using version 0.1.1.1-B I don't seem to be able to copy from Memory Stick or SD card to internal memory. I get the message:

Copying file...
From:b:/Sony Reader/database/books/Sony Reader/...
To:/Data/Author - title.lrf

Failed :-(

The from line is presumably truncated..

Version 0.1.1 does work with SD card and Memory Stick

[gwynevans]

My (4) fix was bad - The line 290 in autorun.js should be reverted to
'path': record.path,
rather than
'path': record.path + "Sony Reader/database/books",


Moderator: WARNING! Does not wotk with books you have in a collection

[keith]

Version 0.1.1.1-C works. Files are copied to the root of the SD card / internal memory.

[vinniet]

Does this program have a problem with deleting books that are part of Collections?

[Ret]

I tried copying files from my SD card to the internal memory with both version 0.1.1.1 and 0.1.1.1-C but I couldn't make the 505 refresh the list after quitting. The new copied file that should be shown on the book list doesn't appear in it. Even taking the SD card out doesn't refresh the list.
How is it supposed to copy a file correctly? or how do I refresh the list?
Thanks

[Ret]

Ok, now I've got it! After taking the card out, I went to the main menu and back to the book list and voilà! the list was all refreshed.
Thanks for a great hack!!

[JSWolf]

Originally Posted by vinniet

Does this program have a problem with deleting books that are part of Collections?

Good question. I'd like to also know if it can copy books that are part of a collection without messing up the collection.

[llasram]

Originally Posted by JSWolf

Good question. I'd like to also know if it can copy books that are part of a collection without messing up the collection.

Copying books which are part of collections shouldn't be a problem, but deleting them will probably make the Reader veeeeery unhappy. That might be hard to fix.

Wow, I haven't been paying attention here -- more interest than I initially thought :-). I'll get off my ass this weekend and move this over to the mobileread dev site, give it a real project, and try to make some coherent combination of some changes I made and gwynevans'.

Also, I did figure out how to do directory traversal ('Iterator' is the function, 'iterator' is the prototype... not sure why I didn't notice that earlier...) which has me considering upending the entire interface. So instead of choosing an operation, one could navigate to a file first, then choose an operation to perform on it. And perhaps one such operation could be "Read," providing the beginnings of a hierarchical interface for accessing the content?