Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Guest management/communication application for LANs (LAN parties).
JavaScript PHP
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
data
scripts
src/LAN
tmp
vendor
www
.gitignore
README.md
composer.json
composer.lock
composer.phar
config.sample.php
index.php

README.md

LAN

Guest management/communication application for LANs (LAN parties). No account required, just visit the server in the browser.

Note

Server must be placed on the same network subnet as the LAN party. Otherwise the system will not be able to determine the MAC address of clients.

Goal

  • Provide a list of users connected to the system. The list will provide:
    • Local IP address of everyone
    • Hostname of everyone
    • Real Name of everyone
  • Provide a communication platform
    • Internal chat functionality
  • Connect it all to a DB for persistence
  • Provide STEAM information (currently playing, join game, etc).

Long term goals

  • Voting
  • Tournament Organization

Requirements

  • php5.3 or greater (5.4 prefered)
  • CURL extension must be installed for PHP
  • Mysql
  • Server that can host the application locally
  • Unix based server. (MAC os X will require that you set the server IP manually in the config file)

Setup

  1. Clone repository to server
  2. Set up mysql user and database
  3. Copy config.sample.php to config.inc.php
  4. Complete the config.inc.php file
  5. Install the database schema: From a command line interface run 'php scripts/install.php'
  6. To run the server, run: 'php bin/server.php'

Set up as a daemon (auto start, run in background)

This is up to you. However, I got it working just fine with supervisord. 1. Install and configure supervisord using this tutorial: http://edvanbeinum.com/how-to-install-and-configure-supervisord 2. For the command, enter something like command=php /var/www/lan/bin/server.php

Some helpful commands for supervisord include:

 #supervisorctl status
 # supervisorctl start yourscriptname
 # supervisorctl stop yourscriptname
Something went wrong with that request. Please try again.