loklak
======

loklak is a server application which is able to collect messages from
various sources, including twitter. The server contains a search index
and a peer-to-peer index sharing interface. All messages are stored in
a elasticsearch index.

'Lok Lak' is also a very tasty Cambodian stir-fry meat dish (usually
beef) with a LOT of fresh black pepper. If you ever have the chance to
eat Beef Lok Lak, please try it. I hope not to scare vegetarians with
this name, currently I am one as well.


*** Why should I use loklak?

If you like to be anonymous when searching things, want to archive
tweets or messages about specific topics and if you are looking for a
tool to create statistics about tweet topics, then you may consider
loklak. With loklak you can do:

- collect and store a very, very large amount of tweets
- create your own search engine for tweets
- omit authentication enforcement for API requests on twitter
- share tweets and tweet archives with other loklak users
- search anonymously on your own search portal
- create your own tweet search portal or statistical evaluations
- use Kibana to analyze large amounts of tweets for statistical data.


*** How can I build loklak myself?

- ant (just this, type "ant" - without quotes - and hit enter)

*** How do I configure loklak?

The basis configuration file is in conf/config.properties.
To customize these settings place a file 'customized_config.properties'
to the path data/settings/

*** How do I run loklak?

- build loklak (you need to do this only once, see above)
- run bin/start.sh
- open http://localhost:9000 in your browser
- to shut down loklak, run bin/stop.sh

*** How do I analyze data aquired by loklak

loklak stores data into an elasticsearch index. There is a front-end
for the index available in elasticsearch-head. To install this, do:
- sudo npm install -g grunt-cli
- cd into the parent directly of loklak_server
- git clone git://github.com/mobz/elasticsearch-head.git
- cd elasticsearch-head
- npm install

Run elasticsearch-head with:
- grunt server
..which opens the administration page at http://localhost:9100

*** Where can I find more information and documentation

The application has built-in documentation web pages, you will see
them when you opened the application web pages or you can simply open
html/index.html or just use http://loklak.org as reference.


*** What is the software license?

LGPL 2.1


*** There should be XXX and YYY can be enhanced!!

This project is considered a community work. There is no company behind
loklak. The development crew consist of YOU also. I am very thankful
for pull request. So if you discovered that something can be enhanced,
please do it yourself and send me a pull request. If you find a bug,
please try to fix it. If you report a bug to me I will possibly
consider it but at the very end of a giant, always growing heap of
work. The best chance for you to get things done is to try it yourself.


*** Where can I report bugs?

Please see above.


*** Where can I download ready-built releases of loklak?

Nowhere, you must clone the git repository of loklak and built it
yourself. Thats easy, just do
- git clone https://github.com/loklak/loklak_server.git
- cd loklak
- then see above ("How do I run loklak")


*** Where can I get the latest news about loklak?

Hey, this is the tool for that! Just put
http://loklak.org/api/search.rss?q=%23loklak into your rss reader.
Oh wait.. you will get a lot of information about tasty Cambodian food
with that as well. Alternatively you may also read the authors timeline
using http://loklak.org/api/search.rss?q=0rb1t3r
or just follow @0rb1t3r (thats a zero after the at sign)

Have fun!
@0rb1t3r
2015-03-07 Frankfurt am Main