P2P Social Network
Ruby Python Shell Other
Switch branches/tags
Latest commit 3e48594 Jul 15, 2017 @Novator version 0.69 alpha
Permalink
Failed to load latest commit information.
base version 0.69 alpha Jul 12, 2017
doc version 0.69 alpha Jul 15, 2017
lang version 0.69 alpha Jul 7, 2017
lib version 0.69 alpha Jul 15, 2017
model version 0.69 alpha Jul 11, 2017
util version 0.69 alpha Apr 8, 2017
view version 0.69 alpha Jul 11, 2017
LICENSE.TXT version 0.2 alfa Mar 30, 2014
README.TXT version 0.69 alpha Jul 9, 2017
git.sh version 0.69 alpha Jul 10, 2017
pandora.bat version 0.69 alpha Jul 7, 2017
pandora.rb version 0.69 alpha Jul 10, 2017
pandora.sh version 0.69 alpha Apr 16, 2017

README.TXT

=== The Pandora. P2P Social Network

Contents

1) overview
2) system requirements
3) installation in Ubuntu
4) installation in Windows
5) installation in Debian
6) preparation of Macosx
7) manual installation or update
8) console user interface
9) join as developer
10) getting help


1. OVERVIEW

Pandora is a free peer-to-peer (P2P) social network application.
It affords functions of instant messenger, audio and video chat, trading
platform, commercial system, payment system, distributed development
system, file exchange and vote system. Pandora has its own binary protocol,
uses a cryptography and a web of trust.

Pandora is not yet another "geek thing". It is designed for ordinary people,
has a graphical user interface (GUI) and works "out of the box".

The concept of Pandora is described in the article:
https://github.com/Novator/Pandora/wiki/P2P-social-network-Pandora

See the user manual with pictures in wiki to quick start:
https://github.com/Novator/Pandora/wiki/Install-and-first-run


2. SYSTEM REQUIREMENTS

Mandatory:
- Linux, Windows or Mac OS
- Ruby1.9 or higher script engine
- GTK2 graphical library
- SQLite3 database library
- OpenSSL crypto library
Optional:
- GStreamer0.1 media library


3. INSTALLATION IN UBUNTU

Do commands in terminal:

  sudo apt-add-repository -y ppa:pandora-net/ppa
  sudo apt-get update
  sudo apt-get install -y --fix-missing pandora-net


4. INSTALLATION IN WINDOWS

Download an installation and run it with administrator:

  http://sourceforge.net/projects/pandora-net/files/pandora_setup.exe
  https://github.com/Novator/Pandora/releases/download/0.3-alpha/pandora_setup.exe


5. INSTALLATION IN DEBIAN

Download a package and install it with root:

  http://sourceforge.net/projects/pandora-net/files/pandora-net_0.6-1ubuntu_all.deb
  https://github.com/Novator/Pandora/releases/download/0.3-alpha/pandora-net_0.2-1ubuntu_all.deb
  dpkg -i pandora-net_0.6-1ubuntu_all.deb
  apt-get -f -y install


6. PREPARATION OF MACOSX

Run these commands in terminal:

  xcode-select --install
  ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  brew update
  brew doctor
  brew install ruby
  brew install rbenv
  brew install ruby-build
  brew install openssl
  echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
  source ~/.bash_profile
  rbenv install -l
  RUBY_CONFIGURE_OPTS=--with-openssl-dir=`brew --prefix openssl` rbenv install 2.2.2
  brew install gtk+
  brew install sqlite3
  brew install Caskroom/cask/xquartz
  sudo gem update --system
  rvm implode
  \curl -sSL https://get.rvm.io | bash -s stable --ruby --autolibs=enable
  rvm reload

Restart your computer. Run also:

  rvm install 2.2.2
  rvm use 2.2.2 --default
  sudo gem install sqlite3
  sudo gem install gtk2

Download and unpack master.zip (see the next chapter), run pandora.sh.


7. MANUAL INSTALLATION OR UPDATE

7.1. Download the archive and unpack it:

  https://github.com/Novator/Pandora/archive/master.zip

7.2. Install needed packages if they still are not installed:

  ruby, ruby-sqlite3, ruby-gtk2, openssl, unzip, ruby-ncurses, ruby-gstreamer,
  gstreamer0.10-x, gstreamer0.10-ffmpeg, gstreamer0.10-plugins-good, gstreamer0.10-plugins-bad

7.3. Set executable rights:

  chmod +x ./pandora.sh

7.4. Copy shortcut to desktop with root and edit paths inside:

  cp ./view/pandora.desktop /usr/share/applications/
  nano /usr/share/applications/pandora.desktop

Pandora can update itself by user click to button on status bar.


8. CONSOLE USER INTERFACE

By default Pandora launches Gtk2 graphical user interface,
but you can force it to launch Ncurses console user interface:

  ./pandora.sh -c   -- this is Curses/Ncurses mode
  ./pandora.sh -s   -- run via screen or return to session
  ./util/pancurse.sh      -- run or return screen session
  ./util/pancurse.sh -d   -- run via screen like a daemon

Console interface is useful on Raspberri Pi, dedicated or
virtual servers, when you need to have day-and-night node.

Attention: CUI has pared-down functionality in comparison with GUI.
It is recommended to setup all preferences in GUI mode on desktop
computer, then move ./base/pandora.sqlite to remote computer.


9. JOIN AS DEVELOPER

9.1. See current technical tasks at file:

  https://github.com/Novator/Pandora/blob/master/doc/todo.ru.txt

9.2. Registrate on GitHub:

  https://github.com/

For example, your login is "YourNick".

9.3. Push "Fork" button on top of Pandora github page:

  https://github.com/Novator/Pandora/fork

9.4. Install git in Ubuntu:

  sudo apt-get -y install git

in Windows download and install:

  https://git-for-windows.github.io/

9.5. Download Pandora to your hard disk via git command:

  git clone --depth=1 https://github.com/YourNick/Pandora.git

Warning: change "YourNick" to your login!

9.6. Correct a code with any text editor, for example Geany:

  http://www.geany.org/Download/Releases

9.7. Update your github repository:

  git commit -a -m "your comment" && git push

(see more useful git commands in the file "git.sh")

9.8. Push "Pull Request" at your Pandora github page:

  https://github.com/YourNick/Pandora/pull/new/master

If your contribution will be rated as useful it will be added to next release.
When you show yourself like active developer you will be added as collaborator.


10. GETTING HELP

Help to Pandora project like a programmer, translator, journalist or donator:

  http://robux.biz/pandora.html

Communicate together in facebook or vkontakte:

  https://www.facebook.com/p2pandora
  https://vk.com/pandoranet

Ask author for help:

  http://facebook.com/robux
  http://vk.com/robux
  robux@mail.ru
  Michael Galyuk

Support development:

  BitCoin: 1PanDR1Q6TL3qE1TSs2Zagt2ihhEiCBHZB