TkCodex is a code viewer for linux written in perl/Tk, so it doesn't need to be compiled or configured. There aren't any non standard modules used, so if you have perl and Tk installed you can run it right away. "Code viewer" means it's for viewing, searching, and marking-up code without modifying the code itself. TkCodex DOES NOT perform any kind of syntax highlighting; it's intended to be used side by side with a full featured text editor (there's even some minor integration with vim) or an actual IDE, and it performs functions additional to this, rather than duplicating existing ones. For this reason, TkCodex uses a read-only display -- you cannot edit the source file you are viewing. Instead, you can do sets of indexed searches, place bookmarks, and add hypertext-style notes. This makes it ideal for tracing variables and function calls. TkCodex also does recursive grep style searches to present you with all instances of a keyword in an entire directory tree of files.

Above is one of three "view windows" (each with four tabs). The source code of TkCodex itself is loaded and marked-up (all the indexed searches, including these hypertext style notes, can be saved together). One is currently displayed in the yellow-on-gray note window. The list down the right side is an index of highlights by line number. You can click on an entry in this index to display it in the text view port. Most of the indexes are the product of simple searches using the text entry and buttons along the top. TkCodex performs both normal "exact" match searches and perl regular expression searches. The big 53 represents the number of instances found in the last match.

Here's the command window, which is all that appears at start-up. The top text entry containing "/home/hack2/booksrc" is a root path -- remember, TkCodex works recursively. The bottom text entry is an optional regular expression to search files for. The file list can then be sorted in order of the number of occurrences in each file (this is the number in parentheses). Files loaded into a view window are preceded by an asterisk. The red numbers shown at bottom reveal which window and tab the selected file is in. Program messages appear in the titlebar.

TkCodex also automatically highlights and indexes subroutines in a separate list which you can switch to using a ctrl key or the menu, shown below.