Skip to content
Negatron, an intuitive front-end for MAME, the well known video game emulator.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper Added Gradle support to release RPM and DEB packages for Linux instea… Oct 21, 2018
lib
nbproject Added again several MAME options and related tooltips. Oct 21, 2018
src
theme Added again several MAME options and related tooltips. Oct 21, 2018
.gitignore
Negatron.sh
README.md
build.gradle
build.xml
gradlew
gradlew.bat
license.txt Initial commit Apr 10, 2018
manifest.mf
settings.gradle Added Gradle support to release RPM and DEB packages for Linux instea… Oct 21, 2018

README.md

Negatron by BabelSoft

PURPOSE

Negatron is yet another front-end for MAME, the well-known multi-system emulator.

The production of Negatron began on July 7th, 2015, because of the inability of any existing front-ends at the time to entirely unlock all the features MAME has to offer, especially since it has completely merged with its sister project MESS in v0.162, which features a dynamic system of contextual configuration of the emulated machines: the slot expansion system.

So Negatron has been engineered to assist users in managing the huge list of machines available in MAME as intuitively as possible, them being arcade machines, consoles or computers. It has been developed in order to be as much hassle-free as possible, checking for any changed or updated resources automatically.

Moreover, Negatron's second objective is to ease the creation of a complete information set dealing with those video games emulated by MAME, using drag and drop operations, and display it in a convenient way. This information set should archive a whole breadth of resources, helping in preserving what is known as the video game history.

PREREQUISITES

Negatron requires a Java runtime environment (JRE) to work: ensure that your computer has at least Java version 8 update 60, or newer. If you have any doubt, you can simply download the latest Java version at http://www.java.com and install it on your computer.

Negatron also requires MAME to be installed on your computer. Although it has only been tested with v0.162 or newer, Negatron should work with MAME / MESS v0.70 and newer as well. You can get the latest version for your specific OS at http://www.mamedev.org. If you plan on using MAME v0.186 or newer, we strongly recommend you to use the derivative NegaMAME instead as recent versions of MAME disabled access to some information on emulated consoles and computers to third-party front-ends. It's available at http://www.babelsoft.net/products/negamame.htm. However, if you only play arcade games, you shouldn't see any differences between official MAME and NegaMAME.

Finally, while not mandatory, Negatron also needs VLC media player 2.2.0 or newer to be installed on your computer in order to play video previews. For this to work, VLC's bitness must match the bitness of the JRE you run with, i.e. if you run Negatron with Java 64-bit, you must install VLC 64-bit as well. You can get the latest version for your specific OS at http://www.videolan.org. Be aware that the site lets you download the Windows 32-bit version by default.

The latest version of Negatron should always be available at http://www.babelsoft.net/products/negatron.htm.

QUICK START

Uncompress Negatron's zip archive file wherever you see fit, then:

  • under Windows, launch Negatron.exe
  • under Linux, launch Negatron.sh
  • under MacOS X, launch Negatron.command

SEE ALSO

For any further information, please refer to the manual (Negatron Manual vXXX.pdf).

LICENSE

Copyright (C) 2015-2018 BabelSoft S.A.S.U.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

COMPILING NEGATRON

The source code to NegaMAME, Negatron and all its dependencies are available at https://github.com/xinyingho/.

To compile NegaMAME:

  1. Download its source code using git i.e. git clone https://github.com/xinyingho/NegaMAME.
  2. Check out the branch of the version of NegaMAME you want to build e.g. git checkout negamame0198 for v0.198.
  3. Check that your repository is really in the good state by doing git describe --dirty. If this command doesn't exactly display the name of the desired tag (usually <branch name>-1, e.g. negamame0198-1), then there's an issue e.g. you may need to force download the tags with git pull --all --tags --prune.
  4. Follow the instructions available at http://docs.mamedev.org/initialsetup/compilingmame.html as NegaMAME has just minor modifications compared to standard MAME.

To compile Negatron:

  1. Create a root folder locally that will hold the source code of Negatron and all its dependencies.
  2. Within this root folder, download the source code of Negatron, Negatron-Preloader, TwelveMonkeys, vlcj-experimental and OpenViewerFX using git. It's important to have them all inside the same root folder as some dependencies will only be available in <root>/Negatron/lib/ and the projects are configured with relative paths.
  3. Switch vlcj-experimental to its "experimental" branch with the command git checkout experimental.
  4. Ensure that you have the latest version of JDK 1.8. For now, Negatron won't work on Java 9 or newer, only on Java 8. Migration to Java 9+ will be done at a later time.
  5. The following instructions have been tested against Apache Netbeans 9.0. But it should also work with other IDEs.
  6. Open all the 5 Java projects in Netbeans. Do not import them, simply use "File > Open Projects...". Netbeans may issue some warnings. Ignore them as they will be solved by compiling the projects.
  7. Compile them in this order and you're done:
    1. TwelveMonkeys
    2. vlcj-experimental
    3. OpenViewerFX
    4. Negatron-Preloader
    5. Negatron

The Windows version of Negatron also has a native executable file to ease launch for Windows users. To compile it:

  1. Download its source code using git i.e. git clone https://github.com/xinyingho/Negatron-Boostrap.
  2. Ensure that you have Visual Studio and that it can manage C++ projects. It's been tested with Visual Studio 2017.
  3. Open the project with Visual Studio and compile it. You're done.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.