Build instructions: Manjaro host, VICE-emu 3.8 guest
From Jay's Cafe' Wiki
- Objective: Create an instance that can be freely redistributable using VirtualBox. VB was chosen specifically for the multi-platform nature of the build. I would like to create a docker, but I'm not there yet.
- Materials:
- Manjaro Install CD (manjaro-kde-22.0-minimal-221224-linux61.iso - latest avail at time of writing)
- QEMU/KVM to provide the Manjaro Host
- VICE 3.8 archive dl'd from Sourceforge
- Jim Brain's 1.15a version of tcpser dl'd from GitHub.com
Build instructions
- Installing the Manjaro host on the VirtualBox hypervisor
- Create the VirtualBox virtual machine using the generic linux 64-bit profile using the following specs:
- Virtual hard drive: 60 GB
- RAM: 4 GB
- CPUs: At least 2, I find 4 is good. More than four CPUs doesn't present a notable difference on my server. YMMV. This will be a setting you may want to toy with after everything is running.
- Attach the Manjaro ISO and start the virtual machine.
- Once booted to the live CD, select "Start Installer" at the bottom of the dialogue box.
- Select your language and select 'Next'.
- Set your timezone of choice and select 'Next'.
- Select your appropriate keymaps and select 'Next'.
- Select 'Erase disk' and 'Swap to file' and select 'Next'.
- Enter your user information. For example:
- Name: VICE User
- Username: viceemu
- Computer Name: vice-virtualbox
- Password: viceemu
- Note - I like my virtual machines to auto login and use the same password as root. There are pros and many cons to this. Use your discretion.
- Select 'Next'.
- Verify the information is correct and select 'Install'.
- Last chance to back out, select 'Install now'.
- Time passes.
- Do not check the box "Restart now" and click on "Done".
- Use the VirtualBox to remove the virtual install CD and power off the computer.
- Using the VirtualBox Management Interface, "Start" the VM.
- The first boot will take some time.
- Create the VirtualBox virtual machine using the generic linux 64-bit profile using the following specs:
- First boot and updating the Manjaro operating system.
- Minimize the Welcome screen and adjust the resolution of the virtual's "Display" to a comfortable resolution. Right-click on clean desktop and select "Configure Display Settings" from the context menu. Larger values require more processing power. VICE looks and runs great on an 800x600 display, but you are going to want a little working area until finished. I suggest 1440x900. It is not that of a drain on resources and it is temporary.
- Set "Power Management" While still in the "System Settings" dialog.
- Under the "On AC Power" tab, uncheck "Screen Energy Saving" and click "Apply" on the bottom right.
- Under "Workspace Behavior | Screen Locking" Uncheck the two boxes to the right of "Lock screen automatically". Click "Apply".
- Dismiss the dialog box.
- Updating the Operating system. Use the VB interface to enable bidirectional clipboard sharing, and you may copy and paste from outside of the OS -- easier if you have a multiple monitor setup.
- To gain root status, open a terminal and type
sudo -i
and enter your password. You are now the all powerfull root.
- Set the system to update to your country.
pacman-mirrors --country United_States pacman -S --needed yay #enter Y at the prompt. exit #returns you to standard user. yay #enter password at prompt
- Enter Y at any replacements suggested unless you have reasons not to. Most of these will be for the operating system and have nothing to do with VICE.
- Answer Y at "Proceed with the installation"
- Time passes. Take a nap unless you have a crazy-fast system. I don't.
Setup build environment and download needed dependencies for tcpser and VICE-emu
sudo pacman -S --needed base-devel gtk3 glew dos2unix xa glib2-devel
Building tcpser
- Set up the build location
cd mkdir -p sandbox/git cd sandbox/git
- Download and make tcpser
git clone https://github.com/go4retro/tcpser cd tcpser make clean make
- Copy tcpser to an acceptable location
sudo cp tcpser /usr/local/bin/
Download VICE-emu
cd ~ mkdir sandbox/src cd sandbox/src wget https://sourceforge.net/projects/vice-emu/files/releases/vice-3.8.tar.gz tar -xvf vice-3.8.tar.gz cd vice-3.8 ./autogen.sh
The next is a little trick which will enable the build of several different configurations of VICE with the same source tree. Make a build directory outside of the source tree, configure and make in that directory.
cd .. mkdir gtk3ui cd gtk3ui ../vice-3.8/configure -C --enable-gtk3ui --disable-pdf-docs make -j $(nproc --all)
Time passes, even on a fast system, this will take a while...but, we are almost there. ...and install
sudo make install
Make a desktop icon with the branded icon and launch instructions
- Right-click on clean desktop and select "Create Link to Application"
- Replace "Link to Applicaton" with "SuperCPU 64" or whatever you wish.
- Click on the generic icon.
- Click on "Browse..." in the lower-left corner of the dialogue box that pops up.
- Navigate to "~/sandbox/src/vice-3.8/data/common/" and select desired icon - "SCPU_64.png" sounds good.
- Under tab "Application" again replace "Link to Application" with "SuperCPU 64"
- In the textbox labled "Program" enter "xscpu64".
- In "Arguments" put whatever command-line arguments to make your life easier. This is where I put the list of drives I want to connect vice to on startup.
- Dismiss the dialogue box, double-click on the desktop icon and you in. You may now configure VICE in whatever way you wish. Adding JiffyROMs, if you have them or others from a myriad of choices.
Enjoy,
Jazzy J
2023-03-11