Skip to content
WWIV BBS Software v5
C++ C CMake Shell Batchfile NSIS Other
Branch: master
Clone or download

README.md

WWIV BBS

WWIV is compiled with the following compilers:

  • MS Visual C++ 2019 Community Edition.
  • GCC 8.3 (or later) on Linux (Debian10, Centos8 (with GCC 8 via SCL) or Ubuntu)

You will need CMake 3.9 or later to build WWIV.


Building WWIV BBS


We prefer contributors to FORK wwivbbs repositories to their account and work from there.

Building on Windows

Installing Git or GitHub Desktop

You will need Git installed. You can use the GitHub Desktop GUI, but it's also easy to use the commandline tool directly. You'll need to download Git and install it. Make sure the git command is in your PATH.

If you are using GitHub Desktop, this is likely in the folder: "Documents\GitHub\WWIV". Otherwise just create a directory and clone your fork. You can follow instructions that are written by GitHub Here. Just make sure that when you clone the repo, you have "Recurse Submodules" specified in the tool, or using --recurse-submodules on the commandline.

Download and Install Visual Studio

WWIV is compiled with the VS2019 compiler for windows. You can download Microsoft Visual Studio 2019 Community

Choose to installthe Desktop development with C++ workload. You also may want to optionally install the following "Individual Components":

   Git For Windows (Only if you do not have this already)
   GitHub extension for Visaul Studio

Build WWIV (Windows)

  • If you cloned a git repository for your fork of WWIV, then select File then Open and choose Folder.

  • If you are using the GitHub for Windows extension, then from the Visual Studio IDE, select File and then Open from Source Control On the bottom, you should see your local GIT repositories already. Above that you will see Login to GitHub, do that.

  • Now in your Local repositories (Documents\GitHub\WWIV), open the folder WWIV in Visual Studio. It should recognize the CMake build and be able to build WWIV.

  • When VS says "READY" on the bottom, go to Build on the menu and select Build Solution(F7). If you have any build errors, run Build one more time and see if that resolves itself as there can be timing issues on some machines.

  • You select whether or not you are building DEBUG or RELEASE on the toolbar. Those binaries and other built files will be places in a \debug and \release folder along side your github source files. ex: Documents\GitHub\WWIV\debug or Documents\GitHub\WWIV\release.

Building on Linux

This only builds the binaries, it does NOT include the supporting files. Please follow the Linux Installation instructions for getting the supporting files in place.

** NOTE:** Do these steps as a non-root user; your BBS user would be the easiest from a file permissions perspective later on. root should never be used to compile binaries.

Install pre-requisite software

Package Comments
git to grab the source code for compiling
ncurses ncurses-devel, libncurses5-dev, etc depending on your distro
cmake 3.9 or later
make for cryptlib
ninja-build 1.8 or later, earlier versions probably work too
g++ 8.3.0 or later (easiest to install via build-essential on debian)

If you are on debian, you can use /builds/jenkins/linux/install-prereqs.sh to ensure that the right software is installed. This command should be executed as root (using sudo)

WWIV Binaries

Here's the list of binaries that will be built in the build directory:

  • bbs/bbs
  • wwivconfig/wwivconfig
  • wwivd/wwivd
  • wwivutil/wwivutil
  • network/network
  • networkb/networkb
  • networkc/networkc
  • networkf/networkf
  • network1/network1
  • network2/network2
  • network3/network3

Getting the source from GitHub

If you plan to have an active repo, we prefer contributors to FORK WWIVBBS repositories to their account and work from there.

  • Fork, then clone your fork

    # Create a directory for your fork's clone.
    mkdir git
    chdir git
    # Clone your fork into the current directory (git).
    # Use your GitHub username instead of <em>YOUR-USERNAME</em>
    git clone --recurse-submodules -j8 https://github.com/<em>YOUR-USERNAME</em>/wwiv.git
  • Navigate to wwiv

Compiling WWIV

Now change directory to the /wwiv directory where you cloned the repository and run the following:

mkdir _build
cd _build 
../cmake-config.sh 
cmake --build . --config Debug

Now you can enter the bbs/admin/unix directory and run sudo ./install.sh


Installation and SysOp Instructions

All the installation and SysOp administration information you need is in the WWIV Documentation


Get Involved

If you want to help out with WWIV BBS:

You can’t perform that action at this time.