Source

cocoat /

Filename Size Date modified Message
Cocoa-t.xcodeproj
English.lproj
PTKeyComboPanel.nib
Sparkle.framework
help
106 B
318 B
1.2 KB
11.1 KB
1.2 KB
465 B
321 B
145 B
271 B
231 B
202 B
332 B
1.0 KB
41.2 KB
825 B
1.3 KB
781 B
5.7 KB
487 B
1.6 KB
713 B
4.0 KB
1.5 KB
673 B
1.7 KB
1008 B
4.2 KB
2.6 KB
3.0 KB
645 B
1.0 KB
369 B
378 B
1.2 KB
258 B
8.8 KB
611 B
2.1 KB
-*- markdown -*-

# Cocoa-t

Cocoa-t is a simple front-end for t. Here is the help document (you can find
the HTML version in help/).

## Download & installation

Download the [binary version of Cocoa-t
1.0](http://bitbucket.org/Kizlum/cocoat/downloads/Cocoa-t_1.0.zip). Download
the [latest source trunk](http://bitbucket.org/Kizlum/cocoat/get/tip.zip).

### The binary version

The binary version is tested for OSX 10.5 and 10.6. It *may* work on 10.4, but
we don't support it. The binary version is just the .app file of Cocoa-t. It
means that you don't have to copy it into your Applications folder (thought
it's recommended). To start cocoa-t, just double click on its icon.

### The source version

You must compile the source in order to use Cocoa-t. That's why you need Xcode
(or at least, gcc and the cocoa/carbon SDK). Just open the .xcodeproj with
Xcode and click on Menu -> Build to create the application.

## Configuration

The first time you start Cocoa-t, you should see the preferences window.

*Remember that you can always open this window: open Cocoa-t then click the
main menu and click the Preferences item.*

The configuration part is totally optional. You can just close the window and
start using Cocoa-t! But if you want to know a bit more about this program,
here are the configuration options:

 * The task path. This is where your tasks will be saved. By default, the path
   is set to "/Users/yourusername/Library/Cocoat". Feel free to change it by
   clicking on the "Select button" on the right of the window.
 * The global hotkeys. These shortcuts are system-wide, it means that you can
   use them where you want (ie: you don't have to click on the cocoa-t icon of
   you Dock to create a new task). Just click on the Edit button if those
   hotkeys don't fit your needs.

## Usage

Cocoa-t is visible in two places: the dock, and the status bar. The dock icon
show how many tasks you have to do (in the example above, I'm productive and
I've 9 tasks left). The icon in the status bar let you manage them. Just left
click on the "t" icon to pop-up a menu.

OK. To finish a task, just click on it. To create a new one, well, just click
the "Newt task" entry to make a HUD style window appear.

Type in the box the text for your new task, then press Enter (or click the
**+** button, whatever you want).

## It's open-source

We use
[Mercurial](http://mercurial.selenic.com/)/[Bitbucket](http://bitbucket.org/)
to manage the source and the issues. Feel free to fork, send patches, bug
tickets, features needs etc...

[The Cocoa-t Bitbucket page.](http://bitbucket.org/Kizlum/cocoat/)

## Credits and licence

Big thanks to [Steve Losh](http://stevelosh.com/) to allow me to release this
application!

Cocoa-t made by [Thomas Pelletier](http://kiznet.fr/) (a.k.a "me" in this
document, and "Kizlum" on the web).

The source code is available at
[Bitbucket](http://bitbucket.org/kizlum/cocoat/). The application and the
source is released under X11 licence (like **t**). If you want to help, go to
the Bitbucket page, read the todo, share your work!