Skip to content
Marko Njegomir edited this page Oct 26, 2019 · 8 revisions

Linux

Our IDE was designed and tested to work on Linux Ubuntu 16.04 or higher.

It was also tested on different Linux distributions, and so far it works on:

UBUNTU

Ubuntu 16.04 or later is required to run i386ide.

We tried to make it run on some older distribution of Ubuntu, such as 12.04, 14.04, but there were many problems with some outdated files that we were not able to solve (most were related to the old version of glibc).

Common prerequisites

To properly run, compile and debug gcc and ddd are required.

GCC

To check if you have gcc installed enter this command in the terminal:
gcc --version
It should list the version of the installed gcc, or tell you if it is not installed. For 64-bit operating systems gcc-multilib is also needed.

To install gcc enter these commands:
sudo apt-get install gcc
sudo apt-get install gcc-multilib

DDD

To check if you have ddd installed enter this command in the terminal:
ddd --version

To install ddd enter this command:
sudo apt-get install ddd

Running an executable file

Other than the common prerequisites, running the executable file should not require any additional installations.

To run the executable file, simply download the version for your operating system, extract the zip archive, and double click on the i386ide file.

Sometimes you will have to manually enable the execution of the i386ide file. It can be done this way:

  1. Right click on the i386ide file, and go to properties
  2. Go to permissions tab
  3. Make sure the box is checked next to the Allow executing file as program option.

Installing and uninstalling using scripts

To install and uninstall i386ide you can use scripts.

Install script

To install simply follow these steps:

  1. Download i386ide archive, and extract i386ide file and icon.
  2. Download and extract the scripts in the same folder where i386ide executable file and the icon are located.
  3. Position yourself in the extracted folder and run sudo bash install.sh to install the program.

This will create a desktop entry, and you will be able to run the program from the terminal, or find it when searching for activities in Ubuntu.

Uninstall script

To uninstall previously installed i386ide, simply follow these steps.

  1. Download and extract the shell scripts to any location.
  2. Position yourself in the extracted folder and run sudo bash uninstall.sh

Running the program from the source code

To run this program from the source code you need Python 3.6 or higher and you have to install PySide2 library.
Run command is python3 main.py

Make sure you have software listed in Common prerequisites installed.

Updating your files

First you should make sure your files are updated by using these commands:
sudo apt-get update
sudo apt-get upgrade

You can also restart your computer to make sure all updates are installed and are being used.

Ubuntu 18.04 or higher

Python 3.6 should come preinstalled on Ubuntu 18.04.

Make sure python3-dev is installed by running the command:
sudo apt install python3-dev

It is easy to install Pyside2 using pip.

PIP

To check if pip is installed for python 3.6 run this command in the terminal:
pip3 --version
If it is not installed, you should run this command to install it:
sudo apt-get install python3-pip

Now you can use pip3 to install additional libraries.

If you have pip installed for Python2, then run all the commands with pip3 instad of pip.

Pyside2

Now that you have pip3 installed, simply use the following command to install Pyside2:
pip3 install pyside2

After pyside2 is installed, you should be able to run the program from source code.
Simply position yourself in the folder that contains the main.py file, and run it by using the command:
python3 main.py

Ubuntu 16.04

Ubuntu 16 comes with Python 3.5 preinstalled, so you will have to install Python 3.6 or higher manually.

Installing python 3.6

To install python3.6 on Ubuntu 16.04 run the following commands:
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.6
sudo apt-get install python3.6-dev

PIP

One way to install pip is by using curl.

First install curl by using:
sudo apt install curl

After that run the following commands to install pip:
sudo su
curl https://bootstrap.pypa.io/ez_setup.py -o - | python3.6
python3.6 -m easy_install pip

To check if pip was installed for python 3.6, enter this command:
python3.6 -m pip --version
or if you don't have pip installed for any other version of python, you can just run:
pip --version

You can then restart your system to make sure everything is loaded.

Pyside2

Now you can install Pyside2 with pip by using the command:
sudo -H python3.6 -m pip install pyside2
or if you don't have pip installed for any other version of python:
sudo -H pip install pyside2

After pyside2 is installed, you should be able to run the program from source code.
Simply position yourself in the folder that contains the main.py file, and run it by using the command:
python3 main.py

Making your own executable with Pyinstaller

It is possible to make your own executable from the source code by using Pyinstaller.

First follow the steps from Running the program from the source code section for the appropriate Ubuntu version.

Pyinstaller for Ubuntu 18.04 or higher

To install pyinstaller just run the command:
pip install pyinstaller

If setuptools is missing then run the command: pip install setuptools

Pyinstaller for Ubuntu 16.04

One way of installing Pyinstaller (especially if you followed the instructions from Running the program from the source code section) is to enter these commands:
sudo -H pip install -U pip setuptools
sudo -H python3.6 -m pip install pyinstaller

Using the pyinstaller

To make sure all the icons are included in the program, you have to make sure to follow the procedure listed here.

First, position yourself in folder where the main.py file is located.

Make and edit .spec file

To pack all resources into one executable file you need to make a .spec file by using:
pyinstaller main.py --onefile

If you instead want to put all the resources into one folder with many files, just create a .spec file with:
pyinstaller main.py

Alternatively, you can try to create a spec file by using: pyi-makespec main.spec --onefile or pyi-makespec main.spec

After that you need to open the main.spec file and edit some lines. In the a = Analysis section you need to add the following values to the datas item:
('./resources/*.png','resources')
('./resources/*.ico','resources')

datas should now look like this:
datas=[('./resources/*.png','resources'),('./resources/*.ico','resources')],
That will add the icons to the executable file that will be created.

In the exe = EXE section, change the name of the program to:
name='i386ide',
That will change the name of the executable file that will be created.

Now save the changes to the main.spec file.

Make the executable file and run it

After that, to finally crate an executable file run the following command:
pyinstaller main.spec

When the process is finished, you can find the created file(s) in the dist folder.

If the spec file was created with the --onefile option, everything will be packed into one executable file.
If the spec file was created without the --onefile option, all files will be placed inside a folder.

Now you can double click on the i386ide file in the dist folder to run the program.
To make sure that the i386ide file can be executed do the following:

  1. Right click on the i386ide file, and go to properties
  2. Go to permissions tab
  3. Make sure the box is checked next to the Allow executing file as program option.

Debian

It is possible to run i386ide on Debian.

It was tested on Debian 10.1.0.

Because of the similarities, you should just follow the guide for Ubuntu 18.04

Mint

It is possible to run i386ide on Mint.

It was tested on Mint 19.2.

Because of the similarities, you should just follow the guide for Ubuntu 18.04

Fedora

We managed to get i386ide working on Fedora 30.1.2.

This guide may not work on earlier versions of Fedora.

Common prerequisites

To properly run, compile and debug gcc and ddd are required.

GCC

To check if you have gcc installed enter this command in the terminal:
gcc --version
It should list the version of the installed gcc, or tell you if it is not installed. For 64-bit operating systems gcc-multilib is also needed.

To install gcc enter these commands:
sudo dnf install gcc
sudo yum install gcc gcc-c++
sudo dnf install glibc-devel.i686

DDD

To check if you have ddd installed enter this command in the terminal:
ddd --version

To install ddd enter this command:
sudo dnf install ddd

Running an executable file

Same procedure for running as it is for Ubuntu.

Installing and uninstalling using scripts

Same procedure for install and uninstall as it is for Ubuntu.

Running the program from the source code

To run this program from the source code you need Python 3.6 or higher and you have to install PySide2 library.
Run command is python3 main.py

Make sure you have software listed in Common prerequisites installed.

Updating your files

First you should make sure your files are updated by using these commands:
sudo dnf check-update
sudo dnf upgrade

You can also restart your computer to make sure all updates are installed and are being used.

Fedora 30.1.2 or higher

Python 3.7 should come preinstalled on Fedora 30.1.2.

It is easy to install Pyside2 using pip.

PIP

To check if pip is installed for python 3.7 run this command in the terminal:
pip3 --version
If it is not installed, you should run this command to install it:
sudo dnf install python3-pip

Now you can use pip3 to install additional libraries.

Pyside2

Now that you have pip3 installed, simply use the following command to install Pyside2:
pip3 install pyside2

After pyside2 is installed, you should be able to run the program from source code.
Simply position yourself in the folder that contains the main.py file, and run it by using the command:
python3 main.py

Making your own executable with Pyinstaller

It is possible to make your own executable from the source code by using Pyinstaller.

First follow the steps from Running the program from the source code section for the Fedora version.

Pyinstaller for Fedora 30.1.2 or higher

To install pyinstaller just run the command:
pip install pyinstaller

Using the pyinstaller

It is the same procedure for using the pyinstaller as it is for Ubuntu.