Cliaspora [discontinued]

About

Cliaspora is a command-line client for the distributed social network DIASPORA*. It compiles and runs under FreeBSD®, OpenBSD, (Mac OS X) and Linux.

Current Version

0.1.9.1

Installation

tar xf cliaspora-0.1.9.1.tgz && cd cliaspora-0.1.9.1 && make install

Manpage

NAME
       cliaspora -- A command-line client for DIASPORA*

SYNOPSIS
       cliaspora [options] command args     ...
       cliaspora session new handle [password]
       cliaspora [-a account] add aspect aspect-name public|private
       cliaspora [-a account] delete post-ID
       cliaspora [-a account] follow tag tagname
       cliaspora [-a account] follow user handle aspect
       cliaspora [-a account] like post-ID
       cliaspora [-a account] list contacts
       cliaspora [-a account] list messages
       cliaspora [-a account] list aspects
       cliaspora [-a account] lookup name|handle
       cliaspora [-a account] reshare post-ID
       cliaspora [-a account] session close
       cliaspora [-a account] show stream
       cliaspora [-a account] show activity
       cliaspora [-a account] show mystream
       cliaspora [-a account] status
       cliaspora [-a account] [-m [-e]] upload aspect file ...
       cliaspora [-a account] [-m [-e]] poll aspect question option1 option2 ...
       cliaspora [-a account] [-e] comment post-ID
       cliaspora [-a account] [-e] message handle [subject]
       cliaspora [-a account] [-e] post      aspect
       cliaspora [-a account] [-e] reply message-ID

DESCRIPTION
       cliaspora  is  a	command-line client for	the distributed	social network
       DIASPORA*. Before you can use cliaspora,	you have to create  a  session
       with

	      cliaspora	session	new yourusername@yourpod.tld

       The  session stays valid	until you create a new session,	close the ses-
       sion, or	it expires. A session usually expires after two	weeks.


OPTIONS
       -a     Use the given account, where account is a DIASPORA handle.

       -e     Use the editor defined by  the editor variable in $HOME/.cliaspo-
              rarc or the environment variable EDITOR to compose your message,
              reply, post, or comment. If the -e  option  was  not  specified,
              cliaspora  reads input from stdin.

       -m     Allows  you  to  post text along with an image upload or a poll.
              See the upload and the poll command below.


COMMANDS
       add aspect
	      Adds aspect-name to your aspect list.

       comment
	      Sends a comment to the given post-ID.

       delete Deletes the post with the	given post-ID.

       follow user
	      Adds the user with the given handle to the aspect.

       follow tag
	      Adds tag-name to your tag	list.

       like   'Likes' the post with the	given post-ID.

       list   Lists your contacts, the index of your private messages, or your
              aspects.

       lookup Looks up the handle or name on DIASPORA*.

       message
              Sends a private message to the given handle.

       post   Sends a new post to the given aspect. If aspect is 'public', the
              post will be visible to everybody.

       reply  Sends a reply to the given private message-ID.

       reshare
	      Reshares the post	with the given post-ID.

       session new
	      Creates a	new session.

       session close
	      Closes the current session.

       show   Shows your last few posts	(mystream), the	last few posts of your
	      main stream (stream), or the last	few  posts  of	your  activity
	      stream (activity). The output is in troff	format and intended to
	      be piped into 'preconv | groff -Tutf8'.

       status Shows the	number of new notifications and	new messages.

       upload Uploads  one  or more image files to the given aspect. If the -m
              option was specified, cliaspora lets you post a text along  with
              the  images. If the -e option was not specified, cliaspora reads
              the text from stdin.

       poll   Starts a poll regarding the given question. At least two options
              people  can  choose  from  must be defined. If the -m option was
              specified, cliaspora lets you post a text along with  the  poll.
              If  the  -e  option  was not specified, cliaspora reads the text
              from stdin.

CONFIG FILE
       cliaspora stores  session related information in the configuration  file 
       $HOME/.cliasporarc, which is a newline separated list of variable-value
       pairs. A variable is separated from its value by an  equal  sign  ('=')
       and  optional  TABs  or  spaces. Values containing white spaces must be
       enclosed in double quotes ('"'). A literal double  quote  or  backslash
       ('\')  must  be  escaped  by  preceding it with a '\'.  Empty lines and
       lines starting with a hash ('#') are ignored.

       For each account there is a block of session related variables. A block
       is  introduced  by a label (user@pod.tld) followed by a colon ':' and a
       newline. Variables defined before the first  block  (global  variables)
       apply to all accounts, but can be redefined in each account block.


   USER  SETTABLE VARIABLES
        editor Defines  an  editor  for  the comment, message, post, upload and
               reply command.

FILES
       $HOME/.cliasporarc
       $HOME/.cliaspora.postponed

BUGS
       Searching  for certain users or handles using the lookup	command	fails.
       Creating a new session sometimes fails, albeit the password is correct.

Download

Download Cliaspora