You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
84 lines
2.6 KiB
84 lines
2.6 KiB
15 years ago
|
======
|
||
|
README
|
||
|
======
|
||
|
|
||
|
About Mitter
|
||
|
============
|
||
|
Mitter is a multi-protocol, multi-interface client for micro-blogging
|
||
|
sites.
|
||
|
|
||
|
Options
|
||
|
=======
|
||
|
To get a list of options Mitter support, you can call it with
|
||
|
``mitter --help``. Along with the default options, you'll get options
|
||
|
for each interface and network.
|
||
|
|
||
|
Config file
|
||
|
-----------
|
||
|
Mitter saves its options in a config file in your home directory,
|
||
|
called ``.mitter.ini``. Some options, not displayed in the command
|
||
|
line options, are available there. Be careful when changing those
|
||
|
options or Mitter may stop working.
|
||
|
|
||
|
In any case, if things don't seem to be working, you can remove this
|
||
|
file and Mitter will ask the necessary options to work again.
|
||
|
|
||
|
Networks
|
||
|
========
|
||
|
As for version 1.0, Mitter supports Twitter.
|
||
|
|
||
|
Interfaces
|
||
|
==========
|
||
|
As for version 1.0, Mitter have the following interfaces: PyGTK, TTY,
|
||
|
Cmd, Zork.
|
||
|
|
||
|
Choosing Interfaces
|
||
|
-------------------
|
||
|
If you want to chose a specific interface, you can use the ``-i``
|
||
|
option, followed by the interface name.
|
||
|
|
||
|
PyGTK
|
||
|
-----
|
||
|
PyGTK is a graphical interface, which uses the GTK toolkit. To be
|
||
|
used, it requires that PyGTK is installed in your system. If you don't
|
||
|
have PyGTK, Mitter will switch to another interface that doesn't
|
||
|
require it.
|
||
|
|
||
|
TTY
|
||
|
---
|
||
|
TTY is a text interface, used to display the updates. It does not
|
||
|
offer any interactivity. You can use it to do automated updates
|
||
|
without user intervention or to simply retrieve the current messages.
|
||
|
|
||
|
Cmd
|
||
|
---
|
||
|
CMD is a text interface, with a command line. It offers some smart
|
||
|
behaviour, like retrieving new messages when there is no option and
|
||
|
starting an update when the command is not recognized.
|
||
|
|
||
|
Zork
|
||
|
----
|
||
|
Zork is another text interface, but works a little bit slowly than the
|
||
|
Cmd interface. Instead of displaying all the messages at once, Zork
|
||
|
displays message by message, requiring the user to jump to the next
|
||
|
message. It offers a fine-grained control to which message to reply,
|
||
|
at the expense of few commands.
|
||
|
|
||
|
How Mitter Finds Interfaces
|
||
|
---------------------------
|
||
|
Mitter uses Python default module loading to find interfaces. This
|
||
|
means: It will search modules starting with the current directory,
|
||
|
then the global system path. When installed via ``setup.py`` or
|
||
|
``easy_install``, interfaces will be installed in the global system
|
||
|
directory; if you don't want to install Mitter, you can run it in the
|
||
|
command line, just be sure to be in the main ``mitter`` directory
|
||
|
before call it.
|
||
|
|
||
|
Suggestions? Bugs?
|
||
|
==================
|
||
|
If you have any suggestions or think your found a bug, don't keep it
|
||
|
to yourself! We have an open bug tracking with Google Code open to the
|
||
|
public. Be sure to check there and drop your opinion:
|
||
|
|
||
|
http://code.google.com/p/mitter/
|