|
TrookDocumentation
Trook Documentation
Featured Using TrookHow do I load a feed of my choice?Tap on the little gear looking icon on the title bar, and enter the URL to the feed you want to load. How do I bookmark this feed?Long-click on the gear icon, and you'll find a menu that lets you bookmark the current URL. The bookmark will go into your "my feeds" area, which is accessible from the Trook root screen. By the way, a bookmark is just a text file with the suffix .bookmarkso feel free to create more bookmarks and upload them through USB. Where do my downloads go, and how can I change it?By default (from Trook rev38 onward) books (epubs, pdfs and pdb files) are downloaded under my documents/Downloads/ while music file go under my music/Downloads/ and apk packages go under my packages/. Please see the answer to the next question on how to change this path. How do I change the default settings for FooI haven't (yet) provided a straightforward for you to change settings, but in the interim (from Trook rev38 onwards) you can at least edit the preferences xml file on the Nook to taste, as follows. Connect over adb and copy /data/data/com.kbs.trook/TrookPreferences.xml locally somewhere. I run something like adb pull /data/data/com.kbs.trook/TrookPreferences.xml TrookPreferences.xml There are preferences for several values, here is a list.
For example, you might prefer to download books to your sdcard rather than the internal storage, which is mounted at /sdcard on the Nook. You might also prefer to keep the wifi on for longer than the default 5 minutes. Edit the TrookPreferences.xml file so that it looks like <?xml version='1.0' encoding='utf-8' standalone='yes' ?> <map> <string name="trook.doc.download.root">/sdcard/Downloads</string> <long name="trook.wifi.holdon" value="600000"/> </map> Please note the different ways that longs and strings are set in this file. Finally, copy it back to the nook adb push TrookPreferences.xml /data/data/com.kbs.trook/TrookPreferences.xml Restart Trook (long-click on the gear icon, scroll down and tap the "Stop Application") and bring up Trook again. How do I enable installing third-party apps from Trook?You'll need to update a settings database on the Nook with sqlite to enable Trook (or any other app) to install applications directly from the Nook. Please see the HOWTO that provides the recipe for this. Can I browse my locally stored books?The "my books" entry from the Trook root menu lets you browse your documents, and preserves any folder structure you have there. How can I add or change the cover art for my book?Just create an image with the same name as the book (but change the suffix as appropriate.) For example, if you have an epub book in my documents/Adventure/Professor Challenger.epubcreate an image called my documents/Adventure/Professor Challenger.jpgYou can create jpg, png or gif files. Can I search a catalog?If a catalog provides a search option, you'll see a magnifying glass icon appear next to the settings. Click on it to search the current catalog. Can I access my Calibre catalog?(Thanks to sethcohn for the tip.) Yes -- start up your calibre server, and load the feed http://server-ip:8080/stanza (Please note -- do not use http://server-ip:8080/ but http://server-ip:8080/stanza If you get a parse error from trook, please double-check the url and verify that it returns a valid atom feed.) You can also bookmark it to "my feeds" so it's conveniently accessible from then on. Also, please see dpierron's pointer to his calibre2opds system (see his comments below) for a way to extract and publish your stanza catalog/books to a service like Dropbox, so you can access your catalog more easily on the internet. How do I change the startup menu?You can override the default menu -- it's just an atom feed -- by creating an xml file called my feeds/root.xmlIt's best to start with the default feed file and modify it as appropriate. Mount the Nook over USB, and create a folder called /my feeds if it doesn't already exist. Then, copy your xml file as /my feeds/root.xml, and make sure that the file is world readable. (If you are accessing your Nook through an adb shell however, the root USB mountpoint is at /system/media/sdcard.) Reset the default feedIf anything should go wrong, if you can see the gear icon at least, bring up the long click menu on it, and select the "Restore default feed" entry. Bring the menu up again, and stop the application. Restarting it should bring up the default feeds again. What sort of Atom feed is this?Trook intends to implement some random subset of OPDS but your best bet is to look at the default feed file and the Stanza catalog format documentation from Lexcycle. At its core, it's just a set of feeds, that can point to other feeds (thus giving hierarchies) or a list of epub files, audio files or (and this is special to Trook) android apk files. By the way, should you ever feel the desire to point to the default feed from your own feed, there's a magic URI asset:default_root_feed.xml For example, if you were creating your own Atom feed, you'd add a section like this: <entry>
<title>Default Trook catalog</title>
<link type="application/atom+xml" href="asset:default_root_feed.xml"/>
<id>asset:default_root_feed.xml</id>
<content type="text">Trook's default catalog</content>
</entry>
| ||||||||||||||
► Sign in to add a comment
Above instructions using 'my feeds' directory didn't work for me... Took the default xml, added a custom entry, saved as root.xml, never saw it load that version of the file. BTW, annoying to use a directory with a space - can you change to use my_feeds, or myfeeds?
calibre server works! used http://localiprunningcalibre:8080/stanza as url Very nice job!!!!
Thanks for update about stanza -- excellent!
Sorry that the root feed is not working -- to eliminate some of the usual suspects, could you check that the file is world-readable after you copy it?
Also, the "my feeds" directory should parallel the other "my XXX" directories (ie, the "my documents" and the "my music" etc directories on the USB connected nook should be at the same level as the "my feeds" directory.)
Yeah, the space for "my feeds" is annoying, agreed. I chose it to stay consistent with the several "my foo" directories that are already present in that area...
I had it wrong (did /my feeds/root/xml in sehll) but doing it the right way (via usb, found the existing "my feeds" right next to the other "my directories") hasn't worked either. It's not a permissions issue (world readable/writable)
Nice app, I wish I owned a Nook to try it ;)
Anyway, I wanted to point out the tool I wrote, called calibre2opds and which can be used to generate a very nice and hierarchic ODPS catalog (along with an HTML one) from the database of Calibre.
This should be useful to your users, IMHO !
All best, David
@sethcohn sorry, been busy updating code -- would you test with the latest version of Trook (rev: 28?) It has a file browsing mode, so if it doesn't work, you can also navigate to the "my feeds" folder, and see what the application thinks it sees in that folder.
@dpierron calibre2opds looks pretty neat, thanks for the pointer -- I've also added a note in the documentation about it.
is it possible to get some more detail instructions about modifying the settings.db file to allow for third party download/installs?
I have a HOWTO on this, and have added a pointer in the FAQ to it as well. Open an adb shell on the Nook, and the HOWTO describes the rest of the steps.
I'm not sure, if I'm doing it correct. If I add my ip:8080/stanza and than hold this button and say add to bookmark. This should appear somewhere in my feeds.
Where exactly can I find this folder? I can see it, when I connect my Nook via usb. It is right there next to my documents etc.
But I cannot find this folder andywhere on my Nook. Is it somewhere in the Trook app? If yes, where? Thanks mos
Hi,When I enter the command adb pull /data/data/com.kbs.trook/TrookPreferences?.xml TrookPreferences?.xml I get back: remote object /data/data/com.kbs.trook/TrookPreferences?.xml does not exist
mos, yes, it is in Trook. Scroll to the right at the top level of Trook and you should find "My feeds." You may have press the refresh button in Trook for the new bookmark you added to appear.
jaybirds2053, the TrookPreferences?.xml file does not exist by default (at least as of Rev 45). You can force Trook to create it by doing a long-press of the settings icon in Trook then choosing "Reset default feed." You will then be able to pull the file via adb. However, you will find it to be basically blank. So, you will have to add the values you want using the information posted in the Wiki above as a guide.
Hi,I try "restore default feed" and I still get no TrookPreferences?.xml file.
Hi,Could you post a TrookPreferences?.xml with setting in the chart above that I could copy to blank TrookPreferences?.xml file and then push to the nook.
The TrookPreferences? stuff was added in later builds. Make sure you are using the latest, Rev 45. There is already a sample just below the table in the Wiki. It only has two settings in it, but you should be able to add the rest.
Every time I try to save a feed my Nook throws and error. I have the latest version of the app. It's like it can't write to the folder on my SD Card. I believe that is where it is trying to save it. I haven't changed the config file. This is a default install. Thanks
Are you able to run "adb logcat" and obtain a stack trace? That will help identify where the problem occurs.
Does TrookPreferences?.xml work at all in rev 53? I wrote one up and it looks perfectly fine, but whenever I try to download anything via trook it saves them to it's default location and not the location I specified in the .xml
For Drito Vales and anyone else with Trook rev53. The preferences xml is located at /data/data/com.kbs.trook/shared_prefs/TrookPreferences?.xml
Hey, Just wondering..
When viewing an rss feed which has the safari compass icon, how do i go back from a story after it is displayed on the e-ink.
There is a back button which takes me out of the app completely to the B&N home (even though I was on the custom home)...
Once i load trook again, it will go to my previous story and e-ink screen will display the browser with no way to go back to the trook menu.
any ideas?
Greg, I have the same problem. Driving me nuts.
I go into Trook and once I have looked at an RSS feed the back button takes me out of trook all together, and if/when I go back into trook I got directly back to the last RSS feed page and I can't get to any control buttons to change the feed/url etc.
ok, Noob question. I installed the softroot 1.3 package and Trook came with it (main reason I soft rooted). How do I upgrade the version of Trook after doing this. I'm on Rev53 and it's got a few problems that 68 seems to resolve.
"I go into Trook and once I have looked at an RSS feed the back button takes me out of trook all together, and if/when I go back into trook I got directly back to the last RSS feed page and I can't get to any control buttons to change the feed/url etc."
I had the same problem...fix, uninstall Trook,, re-install Trook...works perfectly.
I am unable to load any feeds. With the exception of the NYtimes that is preloaded, any feed I try to add comes back as invalid. Any ideas why?
I'm working with Trook version 68. I have some problems
1) Problem with the search, I'm getting a malformed URL error on the search.
2) When I use the browser to go to sideloaded MP3's it tells me there is not a viewer / no activity found to handle action.
In on rev68 and am having some issues with my Calibre integration I can connect to it just fine, but when I get the list of browsing options ("By Newest", "By Title", "By Ratings", etc) I can't select any of them, or at least nothing happens when I touch the appropriate box.
I also have the problem that astrojetson is having with a malformed search URL if I try to perform a search.
I have the same issue as paikens, I can't select any of the Calibre options, "Authors", "Tags", "Recent Additions", etc., isn't selectable, just text.
I've never written xml before, but I was browsing through the xml text, and there seems to be fields for width.
Is it possible to change the size of the icons in Trook by editing the xml? I would like to squeeze in say 4 columns of 5 rows of icons on the LCD.
Same problem as Paikens and jadetrue with the Calibre server, any hint?
Is there any functionality to download rss feeds to be read later offline?
All i want Trook to do is have my calibre Library catalogue as the first feed when I open Trook ... and not 3 levels down in ... My Books, SDcard, calibre
What should the .xml file contain? Where should the .xml file go?
Latest version of Trook trashes Calibre catalog funtionality
I have the same issue as paikens and maxilogan
Simone
hi