Recent changes to Installation

Installation modified by spicer

spicer — Sat, 16 Apr 2022 15:34:43 -0000

--- v8
+++ v9
@@ -9,6 +9,12 @@
 -------------

 ## Unix machines:
+
+### Automated installer for Debian based systems:
+
+https://github.com/ltspicer/dxf2gcode.linux.installer
+
+
 ### Build dependencies:
     - /usr/bin/python3 and development package (>=3.5),
     - PyQt5 (>=5.7),

Discussion for Installation page

Damian Wrobel — Mon, 25 Sep 2017 18:32:35 -0000

Please consider to re-check it using version 20170925.

Installation modified by Damian Wrobel

Damian Wrobel — Mon, 25 Sep 2017 18:30:31 -0000

--- v7
+++ v8
@@ -52,7 +52,7 @@
     - PyQt5 (>=5.9),
     - PyOpenGL (>=3.1),
 #### additional for both source and binary releases
-    - pdftops (>=4.00) [http://www.xpdfreader.com/download.html],
+    - pdftops (>=4.00) [http://www.xpdfreader.com/download.html] (Xpdf-tools package),
     - pstoedit (>=3.70) [https://sourceforge.net/projects/pstoedit/],
     - gswin32c (>=9.09) [https://sourceforge.net/projects/ghostscript/].

@@ -61,7 +61,7 @@
     e.g.: -gs, C:/Program Files (x86)/gs/gs9.09/bin/gswin32c.exe
     (above assumes v9.09 and default path installation).

-    Note(2): pstoedit needs C++ runtime libraries if you don't have please search for:
+    Note(2): pstoedit needs C++ runtime libraries if you don't have it please search for:
     "Microsoft Visual C++ 2010 Redistributable Package (x64)" and install it.
     It is recommended to run both pdftops and pstoedit from command line (CMD) to
     verify the installation correctness.
@@ -109,16 +109,17 @@

 Configuration
 -------------
-  - Unix, Windows:
+##Unix, Windows:
     Basic configuration requires verification of location of pdftops and
-    pstoedit executables in menu Options->Configuration-Software config.
+    pstoedit executables in menu Options->Configuration->Software config.
+    See "Runtime dependencies" above for list of additional dependencies.

-  - Configuration files are stored on all platforms at the following directory:
+    Configuration files are stored on all platforms at the following directory:
         ~/.config/dxf2gcode

     Alternatively the following python code can be used to determine it as well:
-        import os; print(os.path.join(os.path.expanduser("~"),
-        ".config/dxf2gcode").replace("\\", "/"))
+     import os; print(os.path.join(os.path.expanduser("~"),
+     ".config/dxf2gcode").replace("\\", "/"))

 ## Integration in EMC 2.2 and Axis

Installation modified by Damian Wrobel

Damian Wrobel — Mon, 25 Sep 2017 14:25:43 -0000

--- v6
+++ v7
@@ -2,23 +2,123 @@

 Although we aim to make DXF2GCODE work on all major platforms, we would like it if you test it on other platforms (and report the result back to us).

-This page tells you how to install the program on Windows and Linux
+This page tells you how to install the program on Unixes, Windows and macOS (it applies to version 20170925 or newer).

-# Installation on Windows

-There are two ways to install the program on Windows: 
+Prerequisites
+-------------

-  * You can use the packed executable file which doesn't require any installation. Just extract the files to the folder you want 
-  * Extract the source code and install a Python interpreter. A python version of at least 2.6 is recommended.
+## Unix machines:
+### Build dependencies:
+    - /usr/bin/python3 and development package (>=3.5),
+    - PyQt5 (>=5.7),
+    - PyOpenGL (>=3.1),
+    - /usr/bin/lrelease-qt5 or /usr/bin/lrelease5 or /usr/bin/lrelease,
+    - /usr/bin/pylupdate5,
+    - /usr/bin/pyuic5,
+    - /usr/bin/pyrcc5

-The new version of DXF2GCODE has the following dependencies: 
+### Runtime dependencies:
+    - /usr/bin/python3 (>=3.5),
+    - PyQt5 (>=5.7),
+    - PyOpenGL (>=3.1),
+    - /usr/bin/pdftops (>=0.45),
+    - /usr/bin/pstoedit (>=3.70).

-  * Python 2.6 or higher (including 3.0 and above) 
-  * PyQt4 or PyQt5 (depending if you run it in 3d mode you also need PyOpenGl)
+    Note: Depending you used operating system flavour different package names
+    might provides required dependencies. Please use package manager to retrieve
+    those names (e.g. on Fedora Linux use: $ dnf provides /usr/bin/python3).
+    

-# Installation on Linux
+## Windows machine
+### Build dependencies:
+    - python3 (>=3.6.2),
+    - setuptools (>=28.8.0),
+    - sip     (>=4.19.3),
+    - pip     (>=9.0.1),
+    - PyQt5   (>=5.9),
+    - PyOpenGL (>=3.1),
+    - pyqt5-tools (>=5.9.0.1.2),
+    - cx-Freeze   (>=5.0.2).

-There is no installer for Linux. Just put the code where ever you want and run the dxf2gcode.py (the name is dependent on the version you use) file. All files of the program should be in the same folder so Python can find the modules. 
+    Python 3 should be installed from: https://www.python.org/downloads/,
+    during installation pip package should be installed which should install
+    sip, and setuptools packages. Using pip remaining python dependencies like:
+    PyQt5, PyOpenGL, pyqt5-tools and cx-Freeze should be installed.
+
+### Runtime dependencies:
+#### only for source release 
+    - python3 (>=3.6.2),
+    - PyQt5 (>=5.9),
+    - PyOpenGL (>=3.1),
+#### additional for both source and binary releases
+    - pdftops (>=4.00) [http://www.xpdfreader.com/download.html],
+    - pstoedit (>=3.70) [https://sourceforge.net/projects/pstoedit/],
+    - gswin32c (>=9.09) [https://sourceforge.net/projects/ghostscript/].
+
+    Note: if gswin32c is not on the PATH then -gs option needs to be added to
+    pstoedit tool in Options->Configuration->Software config->pstoedit
+    e.g.: -gs, C:/Program Files (x86)/gs/gs9.09/bin/gswin32c.exe
+    (above assumes v9.09 and default path installation).
+    
+    Note(2): pstoedit needs C++ runtime libraries if you don't have please search for:
+    "Microsoft Visual C++ 2010 Redistributable Package (x64)" and install it.
+    It is recommended to run both pdftops and pstoedit from command line (CMD) to
+    verify the installation correctness.
+
+
+Building and Installing
+-----------------------
+
+## Unix (assumes bash shell):
+    $ ./make_tr.py     # generates .qm translation files in i18 directory
+    $ ./make_py_uic.py # generates: dxf2gcode_ui5.py and dxf2gcode_images.qrc
+    $ python3 ./st-setup.py build
+    # python3 ./st-setup.py install
+    $ dxf2gcode
+
+    Note(1): depending on used desktop environment you might need to run:
+    $ /bin/touch --no-create /usr/share/icons/hicolor
+    and/or re-login to make application’s shortcut appears in the system menu.
+
+    Note(2): On Fedora Linux distribution (version >=26) dxf2gode can be
+    installed directly either by using: dnf install dxf2gcode or from
+    your preferred graphical package manager (e.g. GNOME Software)
+    (see also: https://src.fedoraproject.org/rpms/dxf2gcode).
+
+
+## Windows
+### Using source packages
+Assumes python.exe v3 is on PATH and you are using source distribution from [SF files section](https://sourceforge.net/projects/dxf2gcode/files/?source=typ_redirect) (dxf2gcode-YYYYMMDD.zip):
+
+     python.exe ./make_tr.py
+     python.exe ./make_py_uic.py
+     python.exe setup.py bdist_msi
+    
+### Using precompiled binariess
+Assumes you are using MSI installer either created by aforementioned steps or downloaded from [SF files section](https://sourceforge.net/projects/dxf2gcode/files/?source=typ_redirect) (DXF2GCODE-YYYY.MM.DD-win32.msi):
+
+     Install DXF2GCODE-YYYY.MM.DD-win32.msi
+     Launch it from Start Menu by typing: dxf2gcode
+
+## macOS (not tested at all):
+    $ python3 ./make_tr.py
+    $ python3 ./make_py_uic.py
+    $ python3 ./setup.py bdist_dmg # this should create Mac disk image
+
+
+Configuration
+-------------
+  - Unix, Windows:
+    Basic configuration requires verification of location of pdftops and
+    pstoedit executables in menu Options->Configuration-Software config.
+
+  - Configuration files are stored on all platforms at the following directory:
+        ~/.config/dxf2gcode
+
+    Alternatively the following python code can be used to determine it as well:
+        import os; print(os.path.join(os.path.expanduser("~"),
+        ".config/dxf2gcode").replace("\\", "/"))

 ## Integration in EMC 2.2 and Axis

@@ -48,28 +148,11 @@

     [Export Parameters]
     write_to_stdout = 1
+
+# Failure Messages and Solutions

-    
-## Integration of pstoedit for PDF import
-
-in order  to be  able to imprort a PDF or PS (Postscript) file you need to install and configure pstoedit. How to get it and install it please refer to:
-https://sourceforge.net/projects/pstoedit/
-
-As a next step you need to integrate it into dxf2gcode. This needs to be  done by the configuration file or in the newer versions by selecting menu "Options ==> Configuration==>Software config". 
- 
- Section in the config file:
-
-    [Filters]
-    # pstoedit is an external tool to import *.ps (postscript) files and convert them to DXF, in     order to import them in dxf2gcode.
-    pstoedit_cmd = C:/Program Files (x86)/pstoedit/pstoedit.exe
-    pstoedit_opt = -f, dxf, -mm, -dt
-
-The only thing you may need to change is the pstoedit_cmd by  adapting it to your installation folder of pstoedit.
-
-## Failure Messages and Solutions
-    
-    bash: ./dxf2gcode_b02.py:
-     /usr/bin/python^M: bad interpreter: No such file or directory
+    bash: ./dxf2gcode.py:
+     /usr/bin/python3^M: bad interpreter: No such file or directory

 The file may contain carriage return characters. Therefore you need to convert those files first. 

@@ -86,8 +169,3 @@

     chmod +x dxf2gcode.py

-# Installation on Mac OS X
-
-Same requirements as Linux. Known-to-work recent versions of Python can be obtained from: 
-
-  * Python: <http: www.python.org="" download="" releases="" 2.6.4=""/>

Discussion for Installation page

Billy Waggoner — Tue, 18 Jul 2017 20:34:03 -0000

I have done all the appropriate configuring and now instead of getting the PSTOEDIT error message it goes to open my PDF file then immediately closes the application....

Installation modified by chrisko

chrisko — Fri, 13 Jan 2017 10:43:57 -0000

--- v5
+++ v6
@@ -55,7 +55,7 @@
 in order  to be  able to imprort a PDF or PS (Postscript) file you need to install and configure pstoedit. How to get it and install it please refer to:
 https://sourceforge.net/projects/pstoedit/

-As a next step you need to integrate it into dxf2gcode. This needs to be  done by the configuration file or in the newer versions by selecting menu "Option ==> Configurarion==>Software confif". 
+As a next step you need to integrate it into dxf2gcode. This needs to be  done by the configuration file or in the newer versions by selecting menu "Options ==> Configuration==>Software config". 

  Section in the config file:

@@ -64,7 +64,7 @@
     pstoedit_cmd = C:/Program Files (x86)/pstoedit/pstoedit.exe
     pstoedit_opt = -f, dxf, -mm, -dt

-The only thing you may need to change is the pstoedir_cmd by  adapting it to your installation folder of pstoedir.
+The only thing you may need to change is the pstoedit_cmd by  adapting it to your installation folder of pstoedit.

 ## Failure Messages and Solutions

Installation modified by chrisko

chrisko — Fri, 13 Jan 2017 10:37:46 -0000

--- v4
+++ v5
@@ -49,7 +49,8 @@
     [Export Parameters]
     write_to_stdout = 1

-  ## Integration of pstoedit for PDF import
+    
+## Integration of pstoedit for PDF import

 in order  to be  able to imprort a PDF or PS (Postscript) file you need to install and configure pstoedit. How to get it and install it please refer to:
 https://sourceforge.net/projects/pstoedit/

Installation modified by chrisko

chrisko — Fri, 13 Jan 2017 10:36:25 -0000

--- v3
+++ v4
@@ -48,6 +48,22 @@

     [Export Parameters]
     write_to_stdout = 1
+    
+  ## Integration of pstoedit for PDF import
+
+in order  to be  able to imprort a PDF or PS (Postscript) file you need to install and configure pstoedit. How to get it and install it please refer to:
+https://sourceforge.net/projects/pstoedit/
+
+As a next step you need to integrate it into dxf2gcode. This needs to be  done by the configuration file or in the newer versions by selecting menu "Option ==> Configurarion==>Software confif". 
+ 
+ Section in the config file:
+
+    [Filters]
+    # pstoedit is an external tool to import *.ps (postscript) files and convert them to DXF, in     order to import them in dxf2gcode.
+    pstoedit_cmd = C:/Program Files (x86)/pstoedit/pstoedit.exe
+    pstoedit_opt = -f, dxf, -mm, -dt
+
+The only thing you may need to change is the pstoedir_cmd by  adapting it to your installation folder of pstoedir.

 ## Failure Messages and Solutions

Installation modified by J-P

J-P — Sun, 04 Oct 2015 20:30:42 -0000

--- v2
+++ v3
@@ -9,12 +9,12 @@
 There are two ways to install the program on Windows:

   * You can use the packed executable file which doesn't require any installation. Just extract the files to the folder you want 
-  * Extract the source code and install a Python interpreter. A python version of at least 2.6 is recommended. Our current PyQt4 code doesn't work with the new Python version 3.0 
+  * Extract the source code and install a Python interpreter. A python version of at least 2.6 is recommended.

-The new PyQt4 Version of DXF2GCODE has the following dependencies: 
+The new version of DXF2GCODE has the following dependencies: 

-  * Python 2.6 or higher - up to 2.99 (not 3.0 and above) 
-  * PyQt4 
+  * Python 2.6 or higher (including 3.0 and above) 
+  * PyQt4 or PyQt5 (depending if you run it in 3d mode you also need PyOpenGl)

 # Installation on Linux

Installation modified by J-P

J-P — Mon, 08 Jun 2015 19:02:22 -0000

--- v1
+++ v2
@@ -1,18 +1,20 @@
 # Introduction

-This page tells you how to install the program on Windows and Linux 
+Although we aim to make DXF2GCODE work on all major platforms, we would like it if you test it on other platforms (and report the result back to us).
+
+This page tells you how to install the program on Windows and Linux

 # Installation on Windows

 There are two ways to install the program on Windows: 

   * You can use the packed executable file which doesn't require any installation. Just extract the files to the folder you want 
-  * Install the code and a Python distribution. A python version of at least 2.5 is recommended. The code doesn't work with the new Python version 3.0 
+  * Extract the source code and install a Python interpreter. A python version of at least 2.6 is recommended. Our current PyQt4 code doesn't work with the new Python version 3.0 

-The new pyQT Beta Version of DXF2GCODE has the following dependencies: 
+The new PyQt4 Version of DXF2GCODE has the following dependencies: 

-  * Python 2.5 or higher - up to 2.99 (not 3.0 and above) 
-  * pyQT4 
+  * Python 2.6 or higher - up to 2.99 (not 3.0 and above) 
+  * PyQt4 

 # Installation on Linux

@@ -24,7 +26,7 @@

 Another method is to make a symbolic link in the /usr/bin/ folder to the executable file located in a different folder (that's how I do it, remember the name may be different depending on the version) 

-     sudo ln -s /SOMEWHERE/...../dxf2gcode_tkinter/dxf2gcode.py /usr/bin/dxf2gcode.py 
+     sudo ln -s /SOMEWHERE/...../source/dxf2gcode.py /usr/bin/dxf2gcode.py 

 To make the link executable you must type the following code