Tellico

A collection manager for KDE 3.x

Tellico News

13 November 2009
The best Linux collection managers compared | TuxRadar Linux

TuxRadar has an article comparing collection managers. Tellico comes out pretty good, with a grade of 8 out of 10, claiming second place to GCstar.

At first glance, Tellico seemed like the obvious winner of the bunch. It’s got built-in templates, it’s configurable and provides good documentation. The design is elegant, if not pretty, but it’s been superseded by a superior program, one that’s pushed the heights of what a collection manager can be.

Near as I can tell, Tellico loses out to GCstar’s shiny templates! Well, I can take that. It’s a pretty good article, though with not much in the way of substantial critiquing.

Even though you don’t have to fill in all, or even most, of the fields, the result is unappealing. The dialog boxes you use to fill in the information for an item are crowded, but there are also all the ugly empty spaces from fields you didn’t fill in.

I think the author is hitting two points there. I understand the crowded dialog complaint, though aside from doing in-place editing in the view, I can’t think of any other way to edit the data. The second point, about showing empty fields in the view, is easily fixed with some tweaks to the default. Maybe I should add a template for that as an option.

Tellico’s website provides a detailed illustrated guide in addition to the extensive documentation, but the drawback to having extensive built-in support is the in-your-face interface that comes with it, although this is more than offset by the program’s features. When filing our comic book collections, we honestly don’t want to enter the date we purchased the book, so we find it irritating that Tellico expects us to.

Definitely a valid point there at the end of that paragraph. That’s why Tellico 2.0 added a field for automatically storing the date that the comic book was first added to the collection as well as the date of the last modification of the comic book data. I decided not to remove the default field for year of purchase, though maybe I should have.

23 October 2009
Compiling Tellico

I just added a page on KDE UserBase with basic instructions for compiling
Tellico. I know several people have emailed me about that. Typically, I would
recommend waiting for your distribution to provide pre-compiled packages,
but since the transition to KDE4 and Tellico 2.0 is still going on, you may
be impatient.

Feel free to edit or comment.

http://techbase.kde.org/Projects/Tellico/Compiling
http://userbase.kde.org/Tellico

Update: Compilation instructions are properly on KDE TechBase instead of UserBase so I moved them.

29 September 2009
Novell Forge shutting down

I’m even more glad that I moved Tellico into KDE’s svn repository when I did. According to the news at Novell Forge, they’re ceasing to support project hosting…

On December 18, 2009 Novell Forge will be decommissioned. No further access will be available to project contents.

23 September 2009
Changing Amazon terms hits LibraryThing

LibraryThing has had to modify the way they link to their sources of data for their book pages.

Everyone at LibraryThing disagrees with this decision. LibraryThing is not a social cataloging and social networking site for Amazon customers but for book lovers. Most of us are Amazon customers on Tuesday, and buy from a local bookstore or get from a library on Wednesday and Thursday! We recognize Amazon’s value, but we certainly value options.

Importanly, the decision is probably not even good for Amazon. Together with a new request-monitoring system, banning iPhone applications that use Amazon data, and much of their work on the Kindle, Amazon is retreating from its historic commitment to simplicity, flexibility and openness. They won through openness. Their data is all over the web, and with it millions of links to Amazon. They won’t benefit from a retreat here.

Tim Spalding and the gang at LibraryThing have always struck me as being very clear-minded in their goals and the best way to help their users. I agree with their assessment.

Tellico 2.0's first bug

OK, the prize for the first big goofball mistake in Tellico 2.0 is one that causes a crash when exporting to HTML in most cases.

The ironic thing is that I appeared to have created the problem when I updated the export code to allow me to write unit tests for it. HTML export works fine in the test, but Tellico, the app, was setting the configuration wrong. All the articles I’ve read about there being no such thing as a harmless code change are true!

So, my apologies if you download Tellico, created a collection, tried to export your HTML page and promptly get a crash. We’ll hire new Quality Assurance people immediately.

20 September 2009
Tellico 2.0 is finally out there

I just released Tellico 2.0, which is the first version of Tellico for KDE4. It’s taken me a while!

As always, I get rather nervous when I finally get up my courage to make a release. Five times out of 10, I do something stupid and mess up some portion of it. Maybe the i18n configuration, or forgetting some debug code, or adding in a fix that doesn’t work. And then I’ll get one or two angry emails about it.

But on the whole, this is a rather rewarding exercise. Number one, my wonderful wife is downstairs making brownies for us to celebrate. Number two, the number of positive, complimentary emails that I receive far outweigh the negative ones. Number three, I love scratching that itch of programming something that helps me!

This is a .0 release, ported to a new platform. So I expect there to be some whopper bugs in there. I’ve started adding more unit tests, particularly for the data sources and the translators, and those have certainly caught more than a few mistakes on my part. But there are bound to be bugs, so backup your data file if you care about your data!

Moving the Tellico website, source code repository, mailing list, and bug database was no small task either. I have received a lot of help and support from folks on the extragear mailing list, the KDE sysadmins, and many others who take the time to send me suggestions, feedback, and bug reports. Thank you very much!

I don’t have a grand plan for further feature development, at the moment. My thoughts of migrating to a full SQL backend have been shelved. I’m toying with the idea of adding some sort of RDF integration, maybe using the Nepomuk framework. There are also a few additional formats and sources that I would like to add to Tellico. The sky’s the limit!

04 September 2009
The Register writes on the Amazon API

Cade Metz, over at The Register, published an article on Monday about Amazon’s requirement for authenticating API requests. He had called me over the weekend to chat, and we exchanged a couple of emails.

I think he wrote a fairly straight-forward piece, though my wife thinks his quote of my blog post made me sound a bit cold-hearted. Sorry, folks. You’ll just have to use a different search source. Yeah, maybe I could have phrased that better. And I actually think I can backport the implementation fairly quickly to the KDE3 version of Tellico. Just as soon as I get Tellico 2.0 out…

Like any internet article, some of the comments are insightful and some are confused. One accuses me of being a freetard/leech, one confuses application keys with Amazon Associates IDs, and then one guy says:

“Tellico had the same key. It was hard-coded in the source.”

Rather shoddy coding practices on display there, me old mucker.

“Some other application could have used the same key, since it was pretty much public, though”

If you’re an administrator, then you’ll be wanting to keep close tabs the server load which you’re shouldering out of sheer generosity, so it’s of no surprise that they’ve clamped down on security if these open source idiots have been handing out their security keys willy-nilly.

I think this guy forgets what open-source means. Here’s a hint, it means the source is open. Before the authentication requirement, Tellico used an Access Key, purely for identifying the request as coming from Tellico. It wasn’t for security. Sure, you could argue that Tellico should have been requiring users to register for and obtain those keys on their own, from Day 1. In fact, I’ll tentatively agree with you. But by far, the number of desktop applications that utilized the Amazon API, used the Access Key as a way of identifying the generator (application) of the request rather than the source (user) of the request.

I can see this being the driving motive for private keys. Amazon are allowing these (non-profit generating) database queries out of good will, despite these apps clearly being in violation of the T&C (you’re not going to purchase a book or album from Amazon, which you’re software has just catalogued you as clearly already owning.)

I’ve been criticized at least once for including Tellico’s Amazon Associate’s ID as the default setting for HTML export and linking. And true, out of the box, all the Amazon links in Tellico use that ID as essentially, the referrer. But it’s also one of the easiest settings to change, and was included as a config option for the Amazon data source from the beginning. In fact, you could have multiple Amazon sources, each with a different Associates’ ID affiliated with it.

While the affiliate ID has not generated that much in referral fees, it shows that a significant number of people are browsing Amazon products that are linked from Tellico’s HTML export. But maybe the comment writer does have a point. Now, with the requirement that each user provide a secret key, the onus for ensuring that Amazon’s Terms & Conditions are met falls on the user rather than the developer.

If you’re a Mac user, check out Delicious Library. Also notice that it doesn’t give you the option of changing the exported affiliate code. And at first glance, their update to Delicious Library for Amazon’s API switch doesn’t appear to require a user-obtained key as Tellico does. Anyone want to argue that DL has, as its primary purpose, advertising and marketing the Amazon Site? I think that serves as pretty good corroborating evidence of the practices followed by Tellico…

But I do resent being called an open-source idiot! Just for the record…

20 August 2009
Searching Amazon.com from Tellico 1.3.x

Amazon.com has changed their data API to require that all searches be signed with a secret key, unique to each user. The upcoming version of Tellico supports the new method. However, older versions (i.e. all versions of Tellico for KDE3) do not.

As a result, the Amazon searching no longer works for any version of Tellico released for KDE3. I don’t plan to try to backport that support, either.

Sorry, folks. You’ll just have to use a different search source.

By the way, Alexandria has hit the same issue. Books for Macos X hit it, too.

04 August 2009
Tellico 2.0pre1 Released

OK, after long last, I’m reasonably sure that I have a version of Tellico that doesn’t have major issues. So with that, I’m making tellico-2.0pre1.tar.bz2 available.

This release has not been tested by many people yet. If you are not comfortable trying pre-release software, don’t. It may trash your home directory, kill all the whales, and take your dog hostage.

If you’d like to test it, please backup your data first!. The image handling and document loading were both significantly modified, and since they are the crucial components, you should have data backups.

I posted a longer list of new features and notes over on the project website.

Incidentally, I think I’ll start posting news bits over on tellico-project.org and keep blogging about Tellico here at periapsis.org. The news posts there will have comments enabled, too.

03 August 2009
Tellico Website Update

I’ve moved the Tellico website, to its own domain at http://tellico-project.org, and also switched it to a different hosting company, which should save some money. Keeping every single previous release was starting to fill up my (admittedly small) quota.

I took a leap and decided to use Drupal as the CMS. I thought about Wordpress, too, but I wanted to learn something new. I think I figured most of it out, but there are still a few tweaks to be made. I’m about 90% happy with the layout and design.

Most of the links from the periapsis.org domain have redirects setup for them and will continue to work.

Also, the mailing list has moved to the kde.org domain. At the moment, Gmane has updated its information. Nabble has not.

27 May 2009
Tellico has moved into KDE's extragear office module

If you use Tellico’s code from SVN, you’ll need to update your checkout. Tellico has moved into KDE’s extragear module at svn://anonsvn.kde.org/home/kde/trunk/extragear/office/tellico/. Read techbase for info on using KDE’s subversion.

Now that Tellico has moved into its new home, I hope to be able to get a beta release of Tellico 2 out in a month or so, the first version for KDE4. We’ll see how well that goes!

EDIT: fixed SVN location

16 April 2009
Another mention for Tellico

Tellico gets a brief mention on a page listing free software:

This program is a bibliography/collection manager. You can use it to manage your bibliography for school. Using this program, you can easily archive all the bibliography information for all your books so that it is all at your fingertips…even after you return a book to the library. You can also use this software to manage your reading list. I have spent a long time trying to find a free program that would manage my reading list. After a lot of online searching, I gave up and decided that such a thing did not exist. However, while researching for this article, I found Tellico. This program is perfect for managing reading lists. In fact, you can even rate your favorite books using a star system! This program also has an information packet on what Tellico is and how to use it.

Although, I have to wonder. All the rest of the software on the page are Windows-based, or cross-platform. Anyone who tries to run Tellico on Windows right now will be rather disappointed…that doesn’t really get mentioned anywhere.

16 February 2009
Tellico trunk development is now in KDE playground

I just copied Tellico trunk into trunk/playground/office/tellico on the KDE SVN server. You can check out the sources from anonymous SVN by using:

svn co svn://anonsvn.kde.org/home/kde/trunk/playground/office/tellico

I’ll be working on checking out the build system, the i18n generation, etc. and then full-speed ahead with Tellico 2.0!

14 February 2009
Tellico 1.3.5 Released

Tellico 1.3.5, a.k.a. “Valentine’s Reward” dedicated to my wife (!), is available. The md5 sum is ca5d9db11fa1dd33dfe317ffe095435c if you care. This is expected to be the last release of Tellico for the KDE3 desktop, unless some unforeseen bug shows up.

Changelog:

  • Updated entry updating to not combine multiple values.
  • Fixed CueCat decoder to work for UPC and ISBN values.
  • Updated Delicious Library 1 importer to handle movies and games.
  • Fixed query bug with z39.50 ISBN searches.
  • Fixed Ubuntu bug 317822, don’t mark collection modified when image is found in local data directory.
  • Added date, time, and username as available params to XSLT export.
  • Added patch from Jake Maciejewski to fix JavaScript sorting.
  • Fixed crash when exporting to small Alexandria collections.
  • Updated search dialog to open edit box for multiple ISBN search automatically.
  • Added various small performance tweaks.
  • Added option for using SAX loading instead of DOM loading. Still experimental, use —enable-sax.

That last bullet may be of interest to you if you have very large collections. The performance is drastically better for loading Tellico data files. The SAX loader will likely be the default for the next major release of Tellico.

This is the first time I built and ran the KDE3 version of Tellico on my shiny new KDE 4.2. desktop, so I hope I got the package built correctly. Let me know if something seems to be amiss.

10 February 2009
Tellico Plans

Big plans for Tellico are coming up. I hope to get version 1.3.5 released this weekend, with a slew of mostly minor bug-fixes that have been made since 1.3.4 came out last September. That will probably be the last release in the 1.3 branch as well as the last release for the KDE3 platform.

I’m taking the opportunity now, with the jump to KDE4, to do something I’d considered for a while. I requested and received a KDE SVN account, and I plan to eventually move Tellico into the KDE Extragear module. There’s a whole process for moving into KDE SVN, so first Tellico will be in playground, then in kdereview, then, I hope, eventually in the office category for Extragear.

I won’t be importing all of Tellico’s history. It will just be a snapshot upload and moving on from there. The advantages that I hope for in moving onto the KDE server are:

  • Increased visibility in the KDE community
  • More translation help
  • Maybe even some coding help
  • And as someone on the mailing list reminded me, the chance to use KDE’s bugzilla.

Novell Forge has been very dependable in the last year or so after a bit of a rocky start. I really appreciate their generosity in offering project hosting. I’ve not yet decided what I’ll do with the mailing list.

I’d also like to say that I really appreciate the help of everyone who has contributed patches, bug reports, translations, artwork, donations, and even the occasional encouraging email. This is fun stuff! In particular, with the recent work to port to KDE4, Regis Boudin and Petri Damstén have been contributing a lot of code and expertise.

After 1.3.5 gets released, I’ll import a copy of Tellico’s trunk into KDE playground, and we’ll go from there. Happy collecting!