No description
Find a file
2024-08-12 19:33:26 -05:00
.github/workflows Remove more files from final build package 2024-08-06 18:37:19 -05:00
Docker Fix app permissions for auto updater 2024-08-04 23:17:46 -06:00
Docs Basic README 2023-03-03 19:42:22 -06:00
LANCommander.AutoUpdater Fix updater executable 2024-08-09 18:20:13 -05:00
LANCommander.Launcher Add ability to track issues with games 2024-08-11 14:48:00 -05:00
LANCommander.Launcher.CLI Add CLI project 2024-08-07 19:41:42 -05:00
LANCommander.Launcher.Data Bundle PowerShell runtime 2024-08-05 18:02:01 -05:00
LANCommander.Launcher.Models Add game importing via CLI 2024-08-12 19:33:26 -05:00
LANCommander.Launcher.Services Add game importing via CLI 2024-08-12 19:33:26 -05:00
LANCommander.PCGamingWiki Update packages 2024-08-10 12:56:23 -05:00
LANCommander.PowerShell Bundle PowerShell runtime 2024-08-05 18:02:01 -05:00
LANCommander.PowerShell.Tests Fix PowerShell tests project 2024-03-13 00:01:57 -05:00
LANCommander.SDK Add game importing via CLI 2024-08-12 19:33:26 -05:00
LANCommander.SDK.Tests Implement custom play actions. Allow for certain variables in arguments, working directory, and action path. 2024-01-02 20:46:28 -06:00
LANCommander.Server Add game importing via CLI 2024-08-12 19:33:26 -05:00
LANCommander.Steam Update packages 2024-08-12 18:21:01 -05:00
PCGamingWikiClient Lookup player counts from PCGamingWiki for multiplayer modes 2023-01-14 18:22:51 -06:00
Photino.Blazor.CustomWindow@f094309d2d Use branch of custom window submodule 2024-06-19 17:21:07 -05:00
SharpCompress@b89de6caad Use correct submodule version 2024-06-25 17:41:26 -05:00
.gitignore Update ignore file, move server project file 2024-08-04 18:46:57 -05:00
.gitmodules Point towards fix for SharpCompress ZIP64 2024-06-25 17:31:22 -05:00
docker-compose.yml Update docker-compose.yml 2024-03-20 13:10:03 +01:00
LANCommander.sln Add CLI project 2024-08-07 19:41:42 -05:00
LICENSE Create LICENSE 2024-03-24 15:57:40 -05:00
README.md Update README.md 2024-08-04 20:05:50 -05:00

LANCommander

GitHub Release GitHub commit activity GitHub Actions Workflow Status GitHub License Wiki Discord Support me on Patreon

LANCommander is an open-source digital game platform.

The main application is self-hostable and is built on the ASP.NET Blazor web application framework. Your self-hosted platform can be accessed through the offical LANCommander launcher. The database is implemented using SQLite so there is no complex setup required.

The platform is designed to work on local networks and loads no assets from the internet. It was originally developed to help assist a LAN party where the local network is closed and no internet access is permitted.

Builds for Windows, Linux, and macOS are provided, with varying levels of support/compatibility. Currently the launcher has only been tested to run on Windows

Community

Docker

A Docker image is available over at Docker Hub. A sample compose file is provided below:

services:
  lancommander:
    image: lancommander/lancommander:latest
    container_name: lancommander
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/appdata/config:/config
    ports:
      - 1337:1337/tcp   # Webinterface
      - 35891:35891/udp # Beacon Broadcast
    restart: unless-stopped

All config files are available from /config. This include any archive uploads for games. Many of these paths can be changed under Settings if you wish to add additional volume mappings.

Note: The Docker image runs the Linux build and features such as server management may be limited.

FAQ

How do I get games?

The best games are either portable games or DRM-free games. Freeware, shareware, abandonware are all great available options. LANCommander is only a management/distribution system. It does not come bundled with any games.

It's worth joining our Discord as some pre-packaged freeware games are available to download.

I have a pretty large LAN party planned with hundreds of players. I have some sick infrastructure and a LAN cache. What do?

LANCommander communicates over HTTP(S). There is no LAN cache configuration provided, but all downloads are provided through the /api/Games/{id}/Download route.

Where can I get some help?

Some documentation lives at the Wiki including a Getting Started guide and a category for Tutorials. It also contains a large library of sample configurations for Games and Redistributables.

How do I contribute?

Hit that fork button, submit a PR, there are no hard rules right now.

If you're not a developer but still want to contribute, writing documentation in the wiki is a great way to give back to the community!

The LANCommander dev team is currently spearheaded by one developer in their free time. Paid donation tiers are available over at the Patreon page.

SDK

A separate assembly called LANCommander.SDK has been created for use in client applications. Here is a quick example of how one can authenticate to a LANCommander server and install a game to C:\Games:

var client = new LANCommander.SDK.Client("http://localhost:1337", "C:\\Games");

await client.AuthenticateAsync("username", "password");

client.Games.Install("114f653d-ea91-484b-8fe9-8e9bb58bde81");

To Do

LANCommander is far from complete. The basic implementation that exists will allow you to:

  • Manage games
  • Upload archives
  • Manage scripts
  • Manage keys
  • Download games
  • Basic user management
  • New user registration
  • Local "cloud" user saves
  • Dedicated server management/administration
  • Redistributable management and distribution
  • IPX Beacon for emulators such as DosBox
  • Game media management and automatic lookup (covers, icons, backgrounds)
  • Dedicated launcher for easy client setup

The following features are being considered:

  • Peer-to-peer file sharing of game files
  • Built-in VPN client/server for remote LAN parties
  • Social features including chat, friends list, etc.
  • Integration with platforms such as Discord, TeamSpeak, Mumble