Home : thimbl

Thimbl-CLI

A command-line interface for Thimbl.

Prerequisites, downloading, installing, and configuring

Prerequisites:
  • Python programming language installed
  • UNIX-like Operating System. Linux would be ideal, of course, but it will probably also work on Cygwin.
  • Git installed.

    • Downloading: git clone https://github.com/blippy/Thimbl-CLI.git

    Installing: No installation required, just cd Thimbl-CLI and use from there. Ensure that . is in your path

    Configuring: Thimbl-CLI needs to be set up for first use. Issue the command: 

    thimbl setup ADDRESS BIO NAME WEBSITE MOBILE EMAIL
    Each of the parameters are strings, and have the following meanings:
  • ADDRESS: Username and domain for the machine where you have installed Thimbl-CLI, of the form luser@example.com . This is an important field that you must supply.
  • BIO: A brief autobiography, e.g. "Cool cat"
  • NAME: Your real name
  • WEBSITE: Your website URL
  • MOBILE: Your mobile number
  • EMAIL: contact email address
    • You MUST supply the ADDRESS field. The other fields are "mandatory", in the sense that you have to supply something, but there's nothing to stop you from filling them with blanks like so: "". Strings separated with spaces must be put in quotes, too. Here's an example setup: 
    thimbl setup luser@example.com   "Champagne socialist"   "Justin Case"   www.foo.bar.com "" luser@bar.com
    Note that in the example I have used a blank for the mobile phone number, as I don't want other knowing my mobile. Notice, too, how ADDRESS, WEBSITE and EMAIL need bar little relation to each other.

    Usage

    Apart from setup has the following commands and arguments:
  • fetch - retrieve the plans for each person you are following
  • follow NICK ADDRESS - follow someone using a nickname of NICK, and address of ADDRESS. NICK isn't really an important field, but their ADDRESS must be in the form specified above
  • post MSG - post a message
  • print - print the messages of both yourself and the people you follow

    • Here's an example session: 

    thimbl post "First post"
thimbl post "Thimbl rocks"
thimbl follow "dk" "dk@telekommunisten.net"
thimbl fetch
thimbl print

    Reporting problems

    Send an email to: mcturra2000 {at} yahoo {dot} co {dot} uk

    Links to external sites

    Development blog - catch up on my latest notes and commited enhancements fot Thimbl-CLI
    Github repo - location of source code. Download and use. 
    Author:  Mark Carter
Created: 15-Nov-2010
Updated: 27-Nov-2010