Skip to content
Shivam Kumar Jha edited this page May 27, 2018 · 24 revisions

Welcome to the Nephos wiki!

Here you can find all the information required to setup, configuration and running of Nephos on your system.


Abstract

Project Nephos aims at simplifying the process of moving samples from local storage to cloud for Universities by automating, almost, all the steps involved. It will be consisting of three independent modules; a recording module, processing module, and uploading module.

The recording module will be responsible for managing the addition of channel lists, set up of recording jobs and saving the recorded streams. The processing module will parse saved samples, associate tags, extract subtitles and convert the video files to MP4 to reduce the file size. The uploading module will upload the processed stream files, and also share the sample with other universities if required.

Nephos will be developed, using Python and few other open source projects, to accomplish all the above-mentioned tasks with cent-percent reliability and zero failures (unless wrong data is input, which will get logged). Testing and logging will be an integral part of the Nephos development and running cycle, respectively.


Installation (And Setup)

  1. Install Python3
  2. Install Pip
  3. Set the following environment variables for email notifications to work.
  • MAIL_HOST: Host of the mailing service, eg. for GMail, "smtp.gmail.com"
  • MAIL_PORT: Port of the mailing service (for TLS connection), eg. for GMail, "587"
  • CRED_EMAIL: Email address of the sender
  • CRED_PASS: Password of the sender

Install Using PyPI package

NOTE: This method is compromised at the moment!

4.1 Install Nephos
pip install nephos
4.2 Check if the install was successful
nephos version
5. Run Nephos
nephos start

Install Using Git Clone

4.1 Clone the repository
git clone https://github.com/thealphadollar/Nephos.git && cd Nephos
4.2 Install Pipenv
pip install pipenv
4.3 Install nephos' requirements (this step also creates a virtual environment to run nephos)
pipenv install
5. Run Nephos
python3 -m nephos start

Reporting Bugs

Bugs should be reported in the issue tracker. Security issues must be reported at shivam.cs.iit.kgp+nephos@gmail.com to avoid exploitation.


This wiki is a work in progress!