mirror of https://gitlab.com/basile.b/dexed.git
80 lines
5.0 KiB
Markdown
80 lines
5.0 KiB
Markdown
---
|
|
title: Setup
|
|
header-includes: <script src="https://cdnjs.cloudflare.com/ajax/libs/anchor-js/4.2.2/anchor.min.js"></script>
|
|
---
|
|
|
|
There are four ways to get the program:
|
|
|
|
* download and run the setup program build for each release.
|
|
* download and extract the binaries build for each release.
|
|
* [build](build.html) the program from the sources.
|
|
* download and install the official package for a linux distribution.
|
|
|
|
In all the cases, the _DMD_ D2 compiler must setup and its location has to match to one of the directory of the PATH environment variable.
|
|
If it's not already installed, [download](http://dlang.org/download.html) and setup DMD2 for your platform.
|
|
|
|
Note that Windows releases are currently not well integrated to the project host.
|
|
The can be found on [AppVeyor](https://ci.appveyor.com/project/BBasile/dexed/history), from the _Artifacts_ tab visible when clicking one of item that listed.
|
|
|
|
For each platform Dexed can be setup using a setup program or by extracting the binaries.
|
|
|
|
## Linux dependencies
|
|
|
|
The official build of the software is based on the GTK2 toolkit.
|
|
The runtime libraries must be setup (libgtk2, libglib, libgdk-pixbuf2, etc; they usually comes together, libc).
|
|
To enhance the appearence, you can also setup some theme engines (such as Adwaita, Clearlooks, Nimbus, Industrial, etc).
|
|
|
|
## Setup program
|
|
|
|
**Note that this section contains obsolete links and should not be followed unless you put your hands on an old version of the setup program**
|
|
|
|
* Go to [the release page](https://gitlab.com/basile.b/dexed/-/releases),
|
|
* Choose the zipped setup for your platform (at the bottom of a release log, the buttons labeled `dexed.<version>.<platform>.setup.zip`).
|
|
* The content must be extracted and executed:
|
|
* note that the option `--nodcd` can be typed to skip the installation of the completion daemon.
|
|
* Linux, setup for all the users: in a console `cd` to the file location and type `sudo ./dexed.<version>.<platform>.setup`.
|
|
* Linux, setup for the current user: in a console `cd` to the file location and type: `./dexed.<version>.<platform>.setup`.
|
|
* Windows, optional, it may be necessary to deactivate your anti-virus software. Norton AV or McAfee hav been reported for detecting a potential threat.
|
|
* Windows: double click, and confirm in the UAC dialog box.
|
|
* To uninstall, run the same program but with the `-u` option.
|
|
* Linux: if Dexed has been setup with `sudo` you must also uninstall with elevated privileges: `sudo ./dexed.<version>.<platform>.setup -u`.
|
|
* Windows: start a console as administrator and execute: `dexed.<version>.win32.setup -u`.
|
|
* Troubleshooting: run the setup program with the `-l` (or `--list`) option to get the status of the files and use the report to uninstall manually the files or open a ticket [here][https://gitlab.com/basile.b/dexed/issues].
|
|
|
|
Note for the future versions:
|
|
* Updating doesn't require to uninstall.
|
|
* it's possible to uninstall from a newer setup program.
|
|
* always use the same privileges to uninstall or update as used previously.
|
|
|
|
## Binaries
|
|
|
|
**Note that this section contains obsolete links and should not be followed unless you put your hands on an old version of the zips containing the binaries**
|
|
|
|
* Go to [the release page](https://gitlab.com/basile.b/dexed/-/releases),
|
|
* Choose the binaries for your platform (at the bottom of an entry, the buttons labeled `dexed.<version>.<platform>.zip`).
|
|
* Extract the executables
|
|
* Windows: the target folder must be added to your system PATH variable. When the location is not known the background tools won't work (symbol list, todo list, DCD).
|
|
* Linux: libdexed-d shared object should be installed to `/usr/lib`. Alternatively a shortcut can be created and ENV used to indicate a search path,
|
|
e.g `env LD_LIBRARY_PATH=/home/<your account>/bin/dexed /home/<your account>/bin/dexed/dexed` as shortcut command
|
|
if the whole content was extracted to `/home/<your account>/bin/dexed/`.
|
|
|
|
Under Windows, the releases are compressed with the latest [7-zip beta](http://www.7-zip.org/) with the options _deflate-ultra_. In case of problem try to use 7zip.
|
|
Under Linux, the command line tool *zip* is used (_deflate_ and _-9_).
|
|
|
|
Under Linux you could have to set the files permission to allow their execution. This used to be necessary when
|
|
the early versions were all packed on Windows (files attributes were lost) but it shouldn't be the case anymore.
|
|
|
|
If they are not correctly set, for each of the following file **dexed**, **dcd-client**, **dcd-server**, **dastworx**, either set the permission in the context menu (check _allow execution_ or _executable_ depending on the desktop) or `chmod +x` the file in a console.
|
|
|
|
## Linux package
|
|
|
|
Are provided a _deb_ package (Debian and derived Ubuntu, Mint, etc) and a _rpm_ (Fedora, openSUSE), only for x86_64 (amd64).
|
|
After the installation, you must also build [DCD](features_dcd.html).
|
|
|
|
## First steps
|
|
|
|
- verify the [compilers paths](options_compilers_paths.html).
|
|
- check the information [about the tools](widgets_about.html).
|
|
|
|
<script>anchors.add();</script>
|