1 Ansifilter installation instructions 2 ------------------------------------ 3 4 Ansifilter is a small utility without external dependencies. 5 There are no configuration files or libs to take care of. 6 7 1. Compilation and installation 8 =============================== 9 10 1.1 Linux 11 ----------- 12 13 1. tar xjvf ansifilter-x.x.tar.bz2 14 15 2. cd ansifilter-x.x 16 17 3. make help 18 19 4. make 20 make gui (build the Qt GUI (requires Qt 4/5)) 21 22 5. make install (install binary and documentation files) 23 make install-gui (install GUI binary) 24 (depending on your installation destination, you need to be root) 25 26 6. make clean (optional) 27 28 1.2 Windows 29 ----------- 30 31 Install the following tools and libraries. 32 33 a) Install Qt Creator IDE (www.qt.io) 34 35 b) Install MingW (gcc toolchain) 36 37 -Download Online-Installer: 38 https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/installer/ 39 -Start mingw-w64-install.exe and select default options 40 -Add bin directory of the downloaded files to the system PATH 41 -open cmd.exe and type "g++ --version" to check 42 43 c) Compile Qt: 44 45 -Download and extract package from qt.io: 46 https://www.qt.io/download-open-source/ -> qt-everywhere-opensource-src-5.6.0.tar.gz 47 -Open cmd.exe and change into the Qt directory 48 -Configure Qt. Use static if you do not want to ship Qt DLLs: 49 configure -release -nomake examples -opensource -static -strip -opengl desktop 50 -Compile Qt: 51 mingw32-make -j4 52 53 d) Add compiler and Qt paths (location of qmake.exe) in QtCreator 54 55 e) Install upx from http://upx.sourceforge.net/ 56 57 f) Open the pro files in src/w32-projects and src/gui_qt in QtCreator and 58 adjust the paths of libraries and tools before compiling the projects. 59 60 g) Ship Ansifilter with libgcc_s_dw2-1.dll (32 bit) libgcc_s_seh-1.dll (64 bit) libstdc++-6.dll libwinpthread-1.dll 61 (all DLLs are located in the mingw32 installation) 62 63 64 2. Known compiler issues 65 ======================== 66 67 Ansifilter was tested with gcc > 4.8 and clang 3.9.0. It will not compile with gcc 2.x. 68 For gcc versions < 4.7, unique_ptr needs to be replaced by auto_ptr.