Getting Started - Linux: Difference between revisions

From LDraw.org Wiki
Jump to navigation Jump to search
No edit summary
m (it's `yum install` not `yum-install`)
(30 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==Download and Install the LDraw parts Library==
==Download and Install the LDraw parts Library==


===Basic setup (applies to any Linux distribution or operating system - Recommended approach)===


Basic setup (applies to any Linux distribution or operating system - Recommended approach):
*Download the latest <code>complete.zip</code> from [http://www.ldraw.org/parts/latest-parts.html LDraw.org download page].
*Extract the <code>complete.zip</code> archive in the directory of your choice - your home directory is recommended for simplicity (<code>~/ldraw/</code>).


*Download the latest <code>complete.zip</code> from [http://www.ldraw.org/downloads-2/downloads.html LDraw.org download page].
====Updating your parts list====
*Extract the <code>complete.zip</code> archive in the directory of your choice - your home directory is recommended (<code>~/ldraw/</code>) to avoid any file permission conflict or having to tamper with your system as 'root'.
 
'''Tip:'''<br>
'''To avoid cluttering your home directory and potentially or mistakenly deleting your LDraw parts database, we suggest making the 'ldraw' directory hidden by appending a period ('.') to the directory name like so: <code>$ mv ldraw .ldraw</code>'''<br>
'''Feel free to move the LDraw parts directory to a 'safer' location, such as a separate partition or a different part of your system to prevent any such unwanted changes: the library is portable and any editor, viewer, renderer or utility can be directed to its location on your system.'''<br>
 
 
Updating your parts list:


If, for any reason you have decided to alter the original parts directory (<code>~/ldraw/parts.lst</code>), Nathanel Titane has made a Linux native 'mklist.exe' equivalent: 'make-list'.
If, for any reason you have decided to alter the original parts directory (<code>~/ldraw/parts.lst</code>), Nathanel Titane has made a Linux native 'mklist.exe' equivalent: 'make-list'.
The make-list utility operates exactly like its Windows counterpart, and generates a 'parts.lst' file that can be either sorted by part number or part description.
The make-list utility operates exactly like its Windows counterpart, and generates a 'parts.lst' file that can be either sorted by part number or part description.
*Download the [https://raw.githubusercontent.com/nathaneltitane/scripts/master/ldraw/make-list make-list] utility (right click: 'Save link as...')
*Download the utility [https://raw.githubusercontent.com/nathaneltitane/ldraw/master/make-list here] (right click: 'Save link as...')
*Save the utility as 'make-list' to your LDraw parts library directory (<code>~/ldraw/</code>).
*Save the utility as 'make-list' to your LDraw parts library directory (<code>~/ldraw/</code>).
*Run the utility like so: <code>$ ./make-list</code> and follow the prompts.
*Run the utility in the terminal: <code>chmod +x make-list && ./make-list</code> and follow the prompts.


'''Note:'''<br>
'''Note:''' If present, the previous version of the 'parts.lst' file will be backed up.
'''Make sure that the file is set as executable before attempting to run it: <code>$ sudo chmod +x make-list</code>'''<br>
'''If present, the previous version of the 'parts.lst' file will be backed up.'''<br>


===Package-based approach (not recommended, probably very outdated)===


Installer package approach (applies to any Red Hat or Debian based Linux distribution, provided packages exist and are maintained:<br>
This applies to any Red Hat or Debian based Linux distribution, provided packages exist and are maintained:


deb:<br>
====APT-based systems (e.g. Ubuntu, Mint)(very outdated!):====
*To be determined - Online queries do suggest that a new package for Debian based systems is being created and submitted for approval via the [https://ftp-master.debian.org/new/ldraw-parts_1302+ds-1.html Debian package overview server page]
rpm:<br>
*Download the latest (2013-02) version of the parts library packaged by Eli Carter from the [https://retracile.net/blog/2014/05/31/17.00 Retractile blog page].
*Install <code>ldraw_parts-creativecommons-201302-ec4.noarch.rpm</code> using your preferred package manager or command package management tool (yum, rpm).


'''Note:'''<br>
On most Debian-based systems, run <code>sudo apt-get ldraw-parts</code>.
'''This method will unpack the parts library under a more conventional system directory (<code>/usr/share/ldraw</code>) that is only modifiable via 'root' access.'''<br>


==Install an editor==
====YUM-based systems (e.g. Fedora):====


Hybrid setup - Installing MLCad via Wine:<br>
*Download the parts library packaged by Eli Carter from [https://retracile.net/blog/2017/03/25/19.00 the retracile blog page].
*Install <code>ldraw_parts-201601-ec1.fc25.noarch.rpm​</code> and <code>ldraw_parts-creativecommons-201601-ec1.fc25.noarch.rpm​</code> using your preferred package manager or command package management tool (yum, rpm).


*Install [http://www.winehq.org/ Wine] via your distribution's package manager or application repository.
'''Notes:'''
**deb: <code>$ sudo apt-get install wine</code>
*This method will unpack the parts library under a more conventional system directory (<code>/usr/share/ldraw</code>) that is only modifiable via 'root' access.
**rpm: <code>$ sudo yum-install wine</code>
*Download the [http://mlcad.lm-software.com/MLCad_V3.40.zip MLCad archive].
*Extract the <code>MLCad_V3.40.zip</code> archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
**Run MLCad by selecting <code>MLCAD.exe</code> and follow the usual prompts (LDraw parts library directory location and file type registration setup)
**Select Wine as the default method to open an executable on your system and proceed with the previously mentioned steps.


'''Note:'''<br>
==Install an editor==
'''MLCad runs exceptionally well (Platinum status on the Wine's [http://appdb.winehq.org/objectManager.php?sClass=application&iId=1354 AppDB] scale) provided similar instructions are provided on the [http://mlcad.lm-software.com/Linux.htm MLCad website].'''<br>
'''The author of this Wiki, Nathanel Titane, has been running MLCad as his main LDraw editor on Linux for over 8 years without a single issue.'''<br>
'''Any encountered problem, whatever it may be, should be troubleshooted or reported to the Wine developers as they are responsible for maintaining Wine's underlying code base that makes running Windows executables on Linux distributions possible.'''<br>


===LeoCad (recommended)===


Linux native editors:
Leonardo Zide's LeoCAD is readily available for install for both Debian and Red Hat based distributions. You can install the editor by looking for and installing the <code>leocad</code> package using your preferred package manager or command package management tool.
*Install LeoCAD:
**APT-based systems (e.g. Ubuntu, Mint): <code>sudo apt-get install leocad</code>
**YUM-based systems (e.g. Fedora): <code>sudo yum install leocad</code>
*Run LeoCad and point it to the LDraw parts library:
**Go to View > Preferences... and set your library directory by either typing it in the field or browsing to it via '...'. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.


Alternatively, you may want to compile Leocad from source by cloning the subversion repository and issuing the make command. This option assumes you are familiar with compiling your own applications or have knowledge on how to do so.


LeoCad:
Compiling guide:


Leonardo Zide's LeoCAD is readily available for install for both Debian and Red Hat based distributions. You can install the editor by looking for and installing the <code>leocad</code> package using your preferred package manager or command package management tool (apt, dpkg / yum, rpm).
*Install the necessary compilation requirements and build dependencies which are, but are not limited to:
*Install LeoCAD:
**Subversion
**deb: <code>$ sudo apt-get install leocad</code>
**The GNU GCC C++ compiler
**rpm: <code>$ sudo yum-install leocad</code>
**QT4 and/or QT5 development packages
*Run LeoCad and point it to the LDraw parts library:
**The ZLib data compression development package(s)
**Go to View > Preferences... and set your library directory by either typing it in the field or browsing to it via '...'. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.
*Terminal commands:


'''Note:'''<br>
<code>svn co http://svn.leocad.org/trunk leocad</code><br>
'''LeoCAD can use either a zip file or a regular folder as its parts library directory.'''<br>
<code>cd leocad</code><br>
'''You can start Leocad with a different library setup using: <code>$ leocad -l <library directory path></code>'''<br>
<code>qmake leocad.pro</code><br>
'''LeoCAD also supports setting the library path as a system environment variable like so: <code>$ set LEOCAD_LIB=<library directory path></code>'''<br>
<code>make</code><br>


'''Notes:'''
*LeoCAD can use either a zip file or a regular folder as its parts library directory.'''<br>
*You can start Leocad with a different library setup using: <code>$ leocad -l <library directory path></code>'''<br>
*LeoCAD also supports setting the library path as a system environment variable like so: <code>$ set LEOCAD_LIB=<library directory path></code>'''<br>
*If you rather have the latest cutting edge development version of LeoCAD,feel free to [http://www.leocad.org/trac/wiki/CompilingGuide build your own] or download the latest stable pre-built package (now with fully functional MPD file support and other improvements) from the [https://drive.google.com/folderview?id=0B4QpN1vpGh_sUWJZSkVVaEtzcW8&usp=sharing#list LeoCAD downloads page]'''<br>
*LeoCAD supports redirection to the official LDraw parts library.  If you have downloaded and/or set up the LDraw parts directory on your system, you can modify LeoCAD'S preferences to use your library directory as its parts database.  To do so, navigate to View > Preferences and browse to the corresponding directory under the 'Custom parts library' field.'''


LDCad:
===LDCad===


*Go to [http://www.melkert.net/LDCad/download LDCad's download page]
*Go to [http://www.melkert.net/LDCad/download LDCad's download page]
*Select and download the latest generic archive of the LDCad editor.
*Select and download the latest generic archive of the LDCad editor.
*Extract the archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
*Extract the archive in the directory of your choice - your home directory (or a subfolder of it) is recommended for simplicity.
*Run LDCad, follow the prompts and point it to the LDraw parts library. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.
*Run LDCad, follow the prompts and point it to the LDraw parts library. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.


'''Note:'''<br>
'''Note:'''<br>
'''LDCad assumes you are running on a GTK based or compatible desktop environment such as gnome. Make sure you have installed the required packages and libraries to avoid any issues.'''<br>
'''LDCad assumes you have GTK2 installed (just about any distro should have it). Make sure you have installed the required packages and libraries to avoid any issues.'''<br>


 
===LDGLite===
LDGLite:


LDglite is only available as a standalone 64bit binary for Linux. Compared to the other editors, it does pale in comparison to the amount of features present on the more modern ones.
LDglite is only available as a standalone 64bit binary for Linux. Compared to the other editors, it does pale in comparison to the amount of features present on the more modern ones.
Line 95: Line 88:
'''This specific standalone requires libraries such as the dri accelerated opengl libraries, glut, glu, libpng and zlib to be installed.'''
'''This specific standalone requires libraries such as the dri accelerated opengl libraries, glut, glu, libpng and zlib to be installed.'''
'''If, for whatever reason LDGlite fails to start by clicking on the binary, you may run it via a terminal and verify its output, like so: <code>./ldglite</code>'''
'''If, for whatever reason LDGlite fails to start by clicking on the binary, you may run it via a terminal and verify its output, like so: <code>./ldglite</code>'''
<!--


===Konstruktor===


Konstruktor:
Update: this seems to be abandoned.


Konstruktor, created by Park Joon Kyu, is one of the latest attempts to develop a modern, fully integrated and platform independant LDraw model editor. It features a fully modular panel interface as well as full HD POV-Ray rendering capabilities of the model being edited.
Konstruktor, created by Park Joon Kyu, is one of the latest attempts to develop a modern, fully integrated and platform independant LDraw model editor. It features a fully modular panel interface as well as full HD POV-Ray rendering capabilities of the model being edited.
There is no ETA as to when it will be ready, although development continues, to provide a premium alternative to other editors, if those fail to satisfy.
There is no ETA as to when it will be ready, although development continues, to provide a premium alternative to other editors, if those fail to satisfy.
You may visit the temporary webpage [http://konstruktor.influx.kr/ here] or skip directly to its [https://github.com/segfault87/Konstruktor GitHub repository] to test it out, file bugs or help with its development in any other way.
You may visit the temporary webpage [http://wayback.archive.org/web/20141230192950/http://konstruktor.influx.kr/ here] or skip directly to its [https://github.com/segfault87/Konstruktor GitHub repository] to test it out, file bugs or help with its development in any other way.


-->
===MLCAD (Hybrid setup)===


==Related applications:==
*Install [http://www.winehq.org/ Wine] via your distribution's package manager or application repository.
**APT-based systems (e.g. Ubuntu, Mint): <code>sudo apt-get install wine</code>
**YUM-based systems (e.g. Fedora): <code>sudo yum-install wine</code>
*Download the [http://mlcad.lm-software.com/MLCad_V3.40.zip MLCad archive].
*Extract the <code>MLCad_V3.40.zip</code> archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
**Run MLCad by selecting <code>MLCAD.exe</code> and follow the usual prompts (LDraw parts library directory location and file type registration setup)
**Select Wine as the default method to open an executable on your system and proceed with the previously mentioned steps.
 
'''Note:'''<br>
'''MLCad runs exceptionally well (Platinum status on the Wine's [http://appdb.winehq.org/objectManager.php?sClass=application&iId=1354 AppDB] scale) provided similar instructions are provided on the [http://mlcad.lm-software.com/Linux.htm MLCad website].'''<br>
'''Any encountered problem, whatever it may be, should be troubleshooted or reported to the Wine developers as they are responsible for maintaining Wine's underlying code base that makes running Windows executables on Linux distributions possible.'''<br>


==Related applications==


LDView:
===LDView===


LDView, by Travis Cobbs, is a real-time 3D viewer for displaying LDraw models using hardware-accelerated 3D graphics. It is an essential tool in the creation of a model as it can be used to view and debug, in real-time and with full 3D graphics capacity, the model currently being edited (using the auto-update polling preference). It can also generate snapshots of the displayed content or of specific selected views of the given model. LDView is native to the Linux platform and is readily available for install for both Debian and Red Hat based distributions.
LDView, by Travis Cobbs, is a real-time 3D viewer for displaying LDraw models using hardware-accelerated 3D graphics. It is an essential tool in the creation of a model as it can be used to view and debug, in real-time and with full 3D graphics capacity, the model currently being edited (using the auto-update polling preference). It can also generate snapshots of the displayed content or of specific selected views of the given model. LDView is native to the Linux platform and is readily available for install for both Debian and Red Hat based distributions.


*Download the latest installer package from LDView's [http://ldview.sourceforge.net/Downloads.html#Linux4200B1 downloads page].
*Download the latest installer package from LDView's [http://ldview.sourceforge.net/Downloads.html#Linux4200B1 downloads page].
*Install LDView by using your preferred package manager or command package management tool (apt, dpkg / yum, rpm).
*Install LDView by using your preferred package manager or command package management tool.


'''Note:'''<br>
'''Note:'''<br>
'''deb: Your system may complain about either missing packages or unresolved dependencies. You may resolve these by forcing an install fix like so: <code>$ sudo apt-get -f install</code>'''<br>
'''APT-based systems (e.g. Ubuntu, Mint): Your system may complain about either missing packages or unresolved dependencies. You may resolve these by running a "fix install" fix like so: <code>$ sudo apt-get -f install</code>'''<br>
'''rpm: LDView's Linux maintainer, Peter Bartfai, has an [http://download.opensuse.org/repositories/home:/pbartfai/ LDView repository] set up using the OpenSuse build server system, from which you can get the latest LDView version, provided you add the yum repository information as follows:'''<br>
'''YUM-based systems (e.g. Fedora): LDView's Linux maintainer, Peter Bartfai, has an [http://download.opensuse.org/repositories/home:/pbartfai/ LDView repository] set up using the OpenSuse build server system, from which you can get the latest LDView version, provided you add the yum repository information as follows:'''<br>


<code> $ sudo cat > /etc/yum.repos.d/ldview.repo << FILE<br>
<code> $ sudo cat > /etc/yum.repos.d/ldview.repo << FILE<br>
Line 129: Line 137:


'''Tip:'''<br>
'''Tip:'''<br>
'''The variable <code>"$(rpm -E %fedora)"</code> refers to rpm's way (on the Fedora distribution) of finding the current version and attributing the proper number to the URL.'''<br>
'''The variable <code>"$(rpm -E %fedora)"</code> refers to RPM's way (on the Fedora distribution) of finding the current version and attributing the proper number to the URL.'''<br>
'''Note:'''<br>
'''Note:'''<br>
'''The OpenSuse build server team automatically generates the configurations for upcoming or newer versions of any supported Red Hat distribution, ONLY when those distribution versions are finalized, stable and made available to the public.'''<br>
'''The OpenSuse build server team automatically generates the configurations for upcoming or newer versions of any supported Red Hat distribution, ONLY when those distribution versions are finalized, stable and made available to the public.'''<br>


 
===LPub===
LPub:


LPub is Kevin Clague's LDraw building instruction editor. This tool is extremely powerful as it enables the creation of highly detailed, professional looking instructions. It uses external rendering applications to generate the model's step thumbnails to be included in the document. Both LDView and LDGlite are supported.
LPub is Kevin Clague's LDraw building instruction editor. This tool is extremely powerful as it enables the creation of highly detailed, professional looking instructions. It uses external rendering applications to generate the model's step thumbnails to be included in the document. Both LDView and LDGlite are supported.


The port was generated by Eli Carter in 2009 and have been updated (2014) to enable the compilation and packaging of the latest revision of the software for Linux based distributions.
The port was generated by Eli Carter in 2009 and has been updated (2014) to enable the compilation and packaging of the latest revision of the software for Linux based distributions.


You may install LPub as follows:
You may install LPub as follows:


deb:<br>
====APT-based systems (e.g. Ubuntu, Mint):====
 
*Download the latest installer package from Nathanel Titane's latest [https://github.com/nathaneltitane/lpub/tree/master/2014-06-03 LPub Github repository].
*Download the latest installer package from Nathanel Titane's latest [https://github.com/nathaneltitane/lpub/tree/master/2014-06-03 LPub Github repository].
*Install <code>lpub.deb</code> using your preferred package manager or command package management tool (apt, dpkg).
*Install <code>lpub-4.0.0.3-2.deb</code> using your preferred package manager or command package management tool (e.g. <code>sudo dpkg -i lpub-4.0.0.3-2.deb</code>).
rpm:<br>
 
'''Note:''' Your system may complain about either missing packages or unresolved dependencies. You may resolve these by forcing an install fix like so: <code>sudo apt-get -f install</code>
 
====YUM-based systems (e.g. Fedora):====
 
*Download the latest installer package from Eli Carter's [https://retracile.net/blog/2014/05/31/17.20 blog page].
*Download the latest installer package from Eli Carter's [https://retracile.net/blog/2014/05/31/17.20 blog page].
*Install <code>lpub4-4.0.0.14-20140514.ec3.x86_64.rpm</code> using your preferred package manager or command package management tool (yum, rpm).
*Install <code>lpub4-4.0.0.14-20140514.ec3.x86_64.rpm</code> using your preferred package manager or command package management tool (yum, rpm).
'''Note:'''<br>
'''deb: Your system may complain about either missing packages or unresolved dependencies. You may resolve these by forcing an install fix like so: <code>$ sudo apt-get -f install</code>'''<br>


===LDraw Linux Command Line Utilities (L2CU)===
L2CU is a set of command line utilities developed By Nathanel Titane to enable bulk LDraw model file parsing, editing, exporting, conversion and upload (to Sketchfab.com) without the direct need to use an LDraw CAD editor (though it needs to be installed to enable certain application features). Amongst certain modification options, the user can have parts, colors and/or part's colors, for any ldr and/or mpd file modified to his/her choice, within a selected directory.
These tools are especially suited for bulk model file updates, upgrades or modifications: you can attend to deprecated or modified parts in an especially effective manner by:
* replacing an old part entry by a newer one
* replacing a specified color by a different one
* replacing a specific part's color with a new color
'''Notes:'''<br>
*The use of these utilities assumes that the user has previously tested the part/color replacement option manually before parsing all files in bulk.'''<br>
*This application assumes that the model files to be edited abide by the LDraw ldr/mpd file specification.'''
To get the utilities, please visit the dedicated Github page: [http://github.com/nathaneltitane/ldraw LDraw Utilities Github repository]
<!--
Not really directly applicable to this page
===Buf3D/Buf3D+ (Android)===


Buf3D (Android)
Buf3D is an application aimed at bringing the most actual developments of OpenGL technology for model viewing purposes to the Android mobile platform. Amongst many of its supported file formats and model viewing features it includes the ability to view LDraw models. It will prompt you to make use (online) or download of the official LDraw parts library.


In the likes of LDView, Buf3D, developed by Antonio Cortes, is an application aimed at bringing the most actual developments of OpenGL technology for model viewing purposes to the Android mobile platform. Amongst many of its supported file formats and model viewing features, it includes, of course, the capacity to view LDraw models. Whether they are downloaded to your device or viewed through online access via other represented galleries, the application detects the loading of LDraw compatible file formats (.ldr, .dat and .mpd) and will prompt you to make use (online) or download (highly recommended) of the official LDraw parts library.
The newly released Buf3D+ is a bugfix and ad-free version of the initial Buf3D application. Purchasing this version of the application would be of great help in enticing the developer to optimize the current state of the application, updating the framework to the latest Android standards and possibly adding requested features to make it even more formidable.


You can find and install this application via the [https://play.google.com/store/apps/details?id=com.cimplus.buf3d Google Play Store]
* Buf3D on the [https://play.google.com/store/apps/details?id=com.cimplus.buf3d Google Play Store]
* Buf3D+ on the [https://play.google.com/store/apps/details?id=com.cimplus.buf3dp Google Play Store]


'''Note:'''<br>
'''Note:'''<br>
'''The author of this wiki, Nathanel Titane, has contacted the application developer to help enhance the application and bring it to the latest Android and LDraw compatibility standards. The current version is highly efficient in displaying models, though it can still benefit much improvement in the likes of parts database updating and OpenGL shader display functions. Stay tuned!'''
'''The author of this wiki, Nathanel Titane, has contacted the application developer to help enhance the application and bring it to the latest Android and LDraw compatibility standards. The current version is highly efficient in displaying models, though it can still benefit much improvement in the likes of parts database updating and OpenGL shader display functions. Stay tuned!'''


 
-->
==Dive in==
==Dive in==


Line 172: Line 204:
==Disclaimer==
==Disclaimer==


The information above has been validated and tested using Ubuntu 14.04 LTS. Any related information referencing Red Hat distributions such as Fedora have also been validated throughout regular use of the Fedora 20 OS release. Please take care in understanding that most OS development cycles and releases do modify the library or system requirements and thus, will require the user to proceed in new software compilation, installation or external library inclusions. The author of this Wiki hereby releases himself of any responsibility consequent of the actions taken by any user outside of the specified information and steps listed within this Wiki.
The author(s) of this Wiki hereby releases himself/themselfs of any responsibility consequent of the actions taken by any user inside or outside of the specified information and steps listed within this Wiki.


[[Category:Linux]]
[[Category:Linux]]
[[Category:Tutorials]]
[[Category:Tutorials]]

Revision as of 15:12, 8 September 2017

Download and Install the LDraw parts Library

Basic setup (applies to any Linux distribution or operating system - Recommended approach)

  • Download the latest complete.zip from LDraw.org download page.
  • Extract the complete.zip archive in the directory of your choice - your home directory is recommended for simplicity (~/ldraw/).

Updating your parts list

If, for any reason you have decided to alter the original parts directory (~/ldraw/parts.lst), Nathanel Titane has made a Linux native 'mklist.exe' equivalent: 'make-list'. The make-list utility operates exactly like its Windows counterpart, and generates a 'parts.lst' file that can be either sorted by part number or part description.

  • Download the utility here (right click: 'Save link as...')
  • Save the utility as 'make-list' to your LDraw parts library directory (~/ldraw/).
  • Run the utility in the terminal: chmod +x make-list && ./make-list and follow the prompts.

Note: If present, the previous version of the 'parts.lst' file will be backed up.

Package-based approach (not recommended, probably very outdated)

This applies to any Red Hat or Debian based Linux distribution, provided packages exist and are maintained:

APT-based systems (e.g. Ubuntu, Mint)(very outdated!):

On most Debian-based systems, run sudo apt-get ldraw-parts.

YUM-based systems (e.g. Fedora):

  • Download the parts library packaged by Eli Carter from the retracile blog page.
  • Install ldraw_parts-201601-ec1.fc25.noarch.rpm​ and ldraw_parts-creativecommons-201601-ec1.fc25.noarch.rpm​ using your preferred package manager or command package management tool (yum, rpm).

Notes:

  • This method will unpack the parts library under a more conventional system directory (/usr/share/ldraw) that is only modifiable via 'root' access.

Install an editor

LeoCad (recommended)

Leonardo Zide's LeoCAD is readily available for install for both Debian and Red Hat based distributions. You can install the editor by looking for and installing the leocad package using your preferred package manager or command package management tool.

  • Install LeoCAD:
    • APT-based systems (e.g. Ubuntu, Mint): sudo apt-get install leocad
    • YUM-based systems (e.g. Fedora): sudo yum install leocad
  • Run LeoCad and point it to the LDraw parts library:
    • Go to View > Preferences... and set your library directory by either typing it in the field or browsing to it via '...'. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.

Alternatively, you may want to compile Leocad from source by cloning the subversion repository and issuing the make command. This option assumes you are familiar with compiling your own applications or have knowledge on how to do so.

Compiling guide:

  • Install the necessary compilation requirements and build dependencies which are, but are not limited to:
    • Subversion
    • The GNU GCC C++ compiler
    • QT4 and/or QT5 development packages
    • The ZLib data compression development package(s)
  • Terminal commands:

svn co http://svn.leocad.org/trunk leocad
cd leocad
qmake leocad.pro
make

Notes:

  • LeoCAD can use either a zip file or a regular folder as its parts library directory.
  • You can start Leocad with a different library setup using: $ leocad -l <library directory path>
  • LeoCAD also supports setting the library path as a system environment variable like so: $ set LEOCAD_LIB=<library directory path>
  • If you rather have the latest cutting edge development version of LeoCAD,feel free to build your own or download the latest stable pre-built package (now with fully functional MPD file support and other improvements) from the LeoCAD downloads page
  • LeoCAD supports redirection to the official LDraw parts library. If you have downloaded and/or set up the LDraw parts directory on your system, you can modify LeoCAD'S preferences to use your library directory as its parts database. To do so, navigate to View > Preferences and browse to the corresponding directory under the 'Custom parts library' field.

LDCad

  • Go to LDCad's download page
  • Select and download the latest generic archive of the LDCad editor.
  • Extract the archive in the directory of your choice - your home directory (or a subfolder of it) is recommended for simplicity.
  • Run LDCad, follow the prompts and point it to the LDraw parts library. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.

Note:
LDCad assumes you have GTK2 installed (just about any distro should have it). Make sure you have installed the required packages and libraries to avoid any issues.

LDGLite

LDglite is only available as a standalone 64bit binary for Linux. Compared to the other editors, it does pale in comparison to the amount of features present on the more modern ones. If for curiosity's sake you still want to install it, proceed as follows:

  • Download the LDGLite binary archive
  • Extract the archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
  • Run LDGlite, right click on its background to get started.

Note:
Make sure that the binary is set as executable before attempting to run it: $ sudo chmod +x ldglite
This specific standalone requires libraries such as the dri accelerated opengl libraries, glut, glu, libpng and zlib to be installed. If, for whatever reason LDGlite fails to start by clicking on the binary, you may run it via a terminal and verify its output, like so: ./ldglite

MLCAD (Hybrid setup)

  • Install Wine via your distribution's package manager or application repository.
    • APT-based systems (e.g. Ubuntu, Mint): sudo apt-get install wine
    • YUM-based systems (e.g. Fedora): sudo yum-install wine
  • Download the MLCad archive.
  • Extract the MLCad_V3.40.zip archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
    • Run MLCad by selecting MLCAD.exe and follow the usual prompts (LDraw parts library directory location and file type registration setup)
    • Select Wine as the default method to open an executable on your system and proceed with the previously mentioned steps.

Note:
MLCad runs exceptionally well (Platinum status on the Wine's AppDB scale) provided similar instructions are provided on the MLCad website.
Any encountered problem, whatever it may be, should be troubleshooted or reported to the Wine developers as they are responsible for maintaining Wine's underlying code base that makes running Windows executables on Linux distributions possible.

Related applications

LDView

LDView, by Travis Cobbs, is a real-time 3D viewer for displaying LDraw models using hardware-accelerated 3D graphics. It is an essential tool in the creation of a model as it can be used to view and debug, in real-time and with full 3D graphics capacity, the model currently being edited (using the auto-update polling preference). It can also generate snapshots of the displayed content or of specific selected views of the given model. LDView is native to the Linux platform and is readily available for install for both Debian and Red Hat based distributions.

  • Download the latest installer package from LDView's downloads page.
  • Install LDView by using your preferred package manager or command package management tool.

Note:
APT-based systems (e.g. Ubuntu, Mint): Your system may complain about either missing packages or unresolved dependencies. You may resolve these by running a "fix install" fix like so: $ sudo apt-get -f install
YUM-based systems (e.g. Fedora): LDView's Linux maintainer, Peter Bartfai, has an LDView repository set up using the OpenSuse build server system, from which you can get the latest LDView version, provided you add the yum repository information as follows:

$ sudo cat > /etc/yum.repos.d/ldview.repo << FILE
[ldview]
name=LDView Repository
baseurl=http://download.opensuse.org/repositories/home:/pbartfai/Fedora_$(rpm -E %fedora)/
gpgkey=http://download.opensuse.org/repositories/home:/pbartfai/Fedora_$(rpm -E %fedora)/repodata/repomd.xml.key
enabled=1
gpgcheck=0
FILE

Tip:
The variable "$(rpm -E %fedora)" refers to RPM's way (on the Fedora distribution) of finding the current version and attributing the proper number to the URL.
Note:
The OpenSuse build server team automatically generates the configurations for upcoming or newer versions of any supported Red Hat distribution, ONLY when those distribution versions are finalized, stable and made available to the public.

LPub

LPub is Kevin Clague's LDraw building instruction editor. This tool is extremely powerful as it enables the creation of highly detailed, professional looking instructions. It uses external rendering applications to generate the model's step thumbnails to be included in the document. Both LDView and LDGlite are supported.

The port was generated by Eli Carter in 2009 and has been updated (2014) to enable the compilation and packaging of the latest revision of the software for Linux based distributions.

You may install LPub as follows:

APT-based systems (e.g. Ubuntu, Mint):

  • Download the latest installer package from Nathanel Titane's latest LPub Github repository.
  • Install lpub-4.0.0.3-2.deb using your preferred package manager or command package management tool (e.g. sudo dpkg -i lpub-4.0.0.3-2.deb).

Note: Your system may complain about either missing packages or unresolved dependencies. You may resolve these by forcing an install fix like so: sudo apt-get -f install

YUM-based systems (e.g. Fedora):

  • Download the latest installer package from Eli Carter's blog page.
  • Install lpub4-4.0.0.14-20140514.ec3.x86_64.rpm using your preferred package manager or command package management tool (yum, rpm).

LDraw Linux Command Line Utilities (L2CU)

L2CU is a set of command line utilities developed By Nathanel Titane to enable bulk LDraw model file parsing, editing, exporting, conversion and upload (to Sketchfab.com) without the direct need to use an LDraw CAD editor (though it needs to be installed to enable certain application features). Amongst certain modification options, the user can have parts, colors and/or part's colors, for any ldr and/or mpd file modified to his/her choice, within a selected directory.

These tools are especially suited for bulk model file updates, upgrades or modifications: you can attend to deprecated or modified parts in an especially effective manner by:

  • replacing an old part entry by a newer one
  • replacing a specified color by a different one
  • replacing a specific part's color with a new color

Notes:

  • The use of these utilities assumes that the user has previously tested the part/color replacement option manually before parsing all files in bulk.
  • This application assumes that the model files to be edited abide by the LDraw ldr/mpd file specification.

To get the utilities, please visit the dedicated Github page: LDraw Utilities Github repository

Dive in

Learning how to use your new editor or understanding the LDraw file format may be a challenge, but with a little practice you will get the hang of it. Take a look at the tutorials on the wiki or on the main website for further help.

Help

Forums are also a great way to discuss techniques, issues or features of editors or applications used to create or edit your LDraw model files. If you require any further help with any of this content, please visit the LDraw.org Forums, sign up, and ask a large group of users for help.

Disclaimer

The author(s) of this Wiki hereby releases himself/themselfs of any responsibility consequent of the actions taken by any user inside or outside of the specified information and steps listed within this Wiki.