Twister

From ArchWiki
Jump to: navigation, search

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: Several Help:Style violations. (Discuss in Talk:Twister#)

Twister is an experimental peer-to-peer microblogging software. It's in very alpha state!

Installation

The twister-core-gitAUR package and the twister-html-gitAUR html interface are available in the AUR.

First Time Setup

Start the daemon with

# systemctl start twister

Enable the daemon to start on system boot

# systemctl enable twister

This will by default load both the twister-core daemon, and the twister-html gui.

  1. Go to http://user:pwd@127.0.0.1:28332/home.html. If authentication window pops up enter "user" and "pwd"
Note: The "user" and "pwd" is hard coded into the source currently and only accessible from your machine. That is why you create a new user here.
  1. Go to the Network tab and wait until the daemon downloads the entire blockchain.
  2. Go to the Login tab and create a new user.
  3. Wait a few seconds for the daemon to calculate the Proof-Of-Work to propagate your registration.
  4. You’ll be redirected to the Edit Profile tab. Choose your avatar, name, location etc.
  5. Wait a few minutes until your registration is accepted into a new block. The “Save” button will be disabled in the meantime.
  6. Your account is ready.
   IMPORTANT: save your secret key (this is the only way to “authorize”, there's no send me pwd by mail, …)

Search users to follow, send new posts etc.

   A great way for others to find you is by using tags, e.g. write a msg like: Hello #twister community!


Switch to the network tab and wait for the complete download of the blockchain. Go to the 'setup account' tab and create a new user. Wait for your registration to be finished. Edit your profile. Your profile will be set in a new block, so wait for the 'save' button to appear.

The next time you enter the page press **Login** and choose your newly created user to login.

Gui Interface

The twister-html aur package contains a web based gui interface, which can be accessed at http://127.0.0.1:28332/home.html. This interface allows full configuration of Twister, and can be used to create and read posts.

JSON/CLI Interface

Twisterd comes with a command line based utility, that can be used run and configure twister. However, this interface is an overlay on the JSON-RPC interface, and therefore is mostly useful for debugging and development. See the following page for the full documentation of this interface http://twister.net.co/?page_id=58. A brief summary of this interface is as follows.

Creating Users

The following command creates a new username on Twister

# twisterd createwalletuser myname

The following command propagates the user to the network

# twisterd sendnewusertransaction myname

Creating and Viewing Posts

# twisterd newpostmsg myname 1 "hello world"
# twisterd getposts 5 '[{"username":"myname"},{"username":"myfriend"}]'

Private Messages

# twisterd newdirectmsg myname 2 myfriend "secret message"
# twisterd getdirectmsgs myname 10 '[{"username":"myfriend"}]'

Profile Management

# twisterd dhtput myname profile s '{"fullname":"My Name","bio":"just another user","location":"nowhere","url":"twister.net.co"}' myname 1
# twisterd dhtget myfriend profile s

Help

# twisterd help