Installation.md 2.43 KB
Newer Older
Kerenoc's avatar
Kerenoc committed
1 2 3 4
# GCstar installation

GCstar is based on the Perl language and the GTK2 library.

5 6
## Warning

7
Before installing a new version of GCstar, don't forget to make some backups of all your collections!
8

Kerenoc's avatar
Kerenoc committed
9 10
## Linux

Kerenoc's avatar
Kerenoc committed
11
On some Linux distributions, GCstar is available as a package and can be installed using the application manager or with a command line. GCstar can be installed from the source code using the following instructions.
Kerenoc's avatar
Kerenoc committed
12

13
### Dependencies installation with *apt* and *cpan*
Kerenoc's avatar
Kerenoc committed
14

15
Execute the following commands (or similar commands according to the Linux distribution) to install Perl and some libraries
Kerenoc's avatar
Kerenoc committed
16 17 18

````
sudo apt-get install perl
19
sudo apt-get install libgtk2-perl
Kerenoc's avatar
Kerenoc committed
20
cpan install XML::Simple
21
cpan install DateTime::Format::Strptime
22
cpan install JSON
Kerenoc's avatar
Kerenoc committed
23 24
````

25 26
### Installation of the application

27
In the target directory for GCstar, execute the following commands to get a minimal version of GCstar
28 29 30 31 32 33 34

````
wget -O - https://gitlab.com/Kerenoc/GCstar/repository/Test/archive.tar.gz | tar xzf -
mv GCstar-Test-* GCstar
cd GCstar/gcstar/bin
perl gcstar
````
35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
If GCstar was already installed, copy the **gcstar** script in the appropriate binaries directory (probably **/usr/bin**, check with the "which gcstar" command) and copy the **lib** directory in the libraries directory (probably **/usr/lib/gcstar** or **/usr/share/gcstar/lib**).

### Installation of optional modules

To get a fully functional version of GCstar (statistics, importation/exportation, archives), some additional Perl modules are required

````
Archive::Tar
Archive::Zip
Compress::Zlib
Date::Calc
Digest::MD5
GD
GD::Graph
GD::Text
Image::ExifTool
MIME::Base64
MP3::Info
MP3::Tag
Net::FreeDB
Ogg::Vorbis::Header::PurePerl
Time::Piece
````
Kerenoc's avatar
Kerenoc committed
58

59

Kerenoc's avatar
Kerenoc committed
60 61
## Windows 

Kerenoc's avatar
Kerenoc committed
62 63 64
Windows installers for GCstar rely on outdated versions (1.7.0 and 1.7.1). GCstar can be installed from the source code using the following instructions.


Kerenoc's avatar
Kerenoc committed
65 66 67
### Manual installation using *ActivePerl*

- Install Perl from the ActivePerl website
68
- Add a package repository: ````ppm repo add http://www.sisyphusion.tk/ppm/````
Kerenoc's avatar
Kerenoc committed
69 70
- Install the GTK2 library :  ````ppm install gtk2````
- Extract an archive of the current dev version ````https://gitlab.com/Kerenoc/GCstar/repository/Test/archive.zip````
71
- From the newly created directory go into the ````gcstar\bin```` sub-directory
Kerenoc's avatar
Kerenoc committed
72 73
- Execute ````perl gcstar````

Kerenoc's avatar
Kerenoc committed
74 75 76 77 78
### Manual installation using *Strawberry Perl*

- Follow the first part of the instructions available on GitHub ````https://github.com/tothi/gcstar-win32````