i-flicks v1.0.5

i-flicks

Video sharing website and application.

Overview

i-flicks pulls together several components to give a full, open source video sharing application.

i-flicks is intended for small teams or individuals who want a stand alone video presentation system. It will work with a few hundred or low thousands of videos and a handful of concurrent viewers. i-flicks originated from a desire to share family videos hosted on a home server and I couldn't find a fully featured Node implementation.

As of the time of writing this, i-flicks is still in active developmnent and the version number reflects API changes (semantic versioning), not production stability. Database changes should be additive between versions and so new versions won't overwrite your existing videos unless you switch between SQL Server and NEDB or your uploads directory is inside your node_modules folder!).

If you are interested in a larger installation or new features please get in touch as that's the best way to make it happen.

See i-flicks.com for the working example.

Follow @i_flicks

Getting started

You should be able to get i-flicks up and running with no programming experience but you will find a basic understanding of Javascript and Node.js useful.

Quick start (for those who think they know what they are doing)

Create a Node app and pass the i-flicks object to the HTTP server then start the app.

var settings = {
ffmpegPath: '/usr/bin/ffmpeg',
ffprobePath:  '/usr/bin/ffprobe',
flvMetaPath:  '/usr/bin/flvmeta',
uploadPath: '/var/uploads/i-flicks',
	mediaPath: '/var/uploads/i-flicks',
sessionSecret: 'my secret',
baseURL: 'http://localhost:3000/',
	databaseType: 'nedb',
	usersCanCreateAccount: true
 };
var http = require('http');
var server = http.createServer(require('i-flicks')(settings));

server.listen(3000, function() {
	var addr = this.address();
	console.log('i-flicks server is listening on %s:%d', addr.address, addr.port);
});

node app.js

Detailed install

Ubuntu Linux

Install Node.js, NPM ImageMagick, Git and FLVMeta.

curl -sL https://deb.nodesource.com/setup | sudo bash -

or

curl -sL https://deb.nodesource.com/setup_0.12 | sudo bash -

sudo apt-get install nodejs -y

sudo apt-get install git -y

sudo apt-get install graphicsmagick -y

sudo apt-get install flvmeta -y

Install FFmpeg

sudo add-apt-repository ppa:mc3man/trusty-media

sudo apt-get update

sudo apt-get dist-upgrade  ?? not really required ??

sudo apt-get install ffmpeg -y

Note: because of licencing restrictions, you can get better sound quality and browser compatibility by compiling FFmpeg from source. i-flicks works with the standard download.

Windows The default settings and latest installs of the following packages should all work.

• Download and install Node.js (this will install NPM too)

• Download and install Git

• Download and install GraphicsMagick

• Download and install FLVMeta

• Download and install FFMpeg

For all operating systems Create a folder for your new project on your computer and move to that folder.
run:

npm install i-flicks

Check the runOnce file exists.  Sometimes we forget to rename it before deploying to NPM.  If it doesn't then rename the .done file:  
cd node_modules/i-flicks/views  
mv runOnce.done.hbs runOnce.hbs *OR* rename runOnce.done.hbs runOnce.hbs  

There is currently a bug in Fluent-FFmpeg which means videos in portrait mode cause a crash.
Open file below your install folder at ./node_modults/i-flicks/node_modules/fluent_ffmpeg/lib/ffprobe.js
Add "lines = lines.filter(Boolean);" to line 15. Check the Github issue for updates.

Create a node application, create a "settings" object with paths to the software installed above and require i-flicks....
For example, add this to a file called app.js

var settings = {
    ffmpegPath: '/usr/bin/ffmpeg',
    ffprobePath:  '/usr/bin/ffprobe',
    flvMetaPath:  '/usr/bin/flvmeta',
    databasePath: '',
    uploadPath: '/var/uploads/i-flicks',
    mediaPath: '/var/uploads/i-flicks',
    sessionSecret: 'enter your secret here',
    env: 'production', // development or production. 

css: 'white.css' // white.css or black_yellow.css

 };
var iflicks = require('i-flicks')(settings);
var http = require('http');
var server = http.createServer(iflicks);

server.listen(3000, function() {
	var addr = this.address();
	console.log('i-flicks server is listening on %s:%d', addr.address, addr.port);
});

run:
node app.js

Open a browser and navigate to http://localhost:3000

How to listen on port 80
Node.js requires elevated privileges or root access to listen on port 80 or 443. It isn't a good idea to do this and so something needs to forward requests to port 80 onto the Node.js port. IPTables or Nginx both work. IPTables is quicker to setup as it is installed on most Linux distrubutions. Nginx works on Windows and Linux and adds a bit more flexibility.

What about io.js, HTTPS, SPDY or HTTP2?
i-flicks works with other io.js amd alternative HTTP modules. None have been production tested but all work when tested as a Friday afternoon bit of fun.

Settings

The settings object options are as follows:

Linux permissions

sudo -i
chown -R www-data:www-data /var/www
chmod go-rwx /var/www
chmod go+x /var/www
chgrp -R www-data /var/www
chmod -R go-rwx /var/www
chmod -R g+rx /var/www
chmod -R g+rwx /var/www

chown -R www-data:www-data /var/uploads/i-flicks

Credit goes to http://fideloper.com/user-group-permissions-chmod-apache for this.

More

If you use i-flicks or would like to see a specific feature please drop Nick an email at contact@i-flicks.com. He would love to hear what you are doing.

i-flicks has a "Send" feature which allows videos to be sent from one installation to another. If you are logged in and view a video this option is available at the bottom of the video.

Errors can be viewed, users created and all sorts of other things via http://localhost:3000/toolbox. You need to be logged in otherwise it will just redirect you to the home page.

i-flicks will remember the previous volume and postion in a video for logged in users.