goimgshare

GO Image and video share

GO Image and video share is a program that creates a file sharing website useful to share images and other files. The main features are:

• Support for Facebook authentication
• Support for Google authentication
• Support for GitHub authentication.
• Automatic image resize for faster thumbnails (with cache)

How install

Check GO installation

Ensure to have GO installed (tested with 1.5). If not sure issue:

go version

from command line. Make sure to have a valid $GOPATH environment variable.

Get the source code

go get -u github.com/mindflavor/goimgshare

This will get the source code. You can use the same command later to update the source code.

Copy sample configuration files

This step is optional, you can edit the original files without copying them. In that case, however, you will have to stash your changes before updating the source code.

cp $GOPATH/src/github.com/mindflavor/goimgshare/config.json /etc/goimgshare/config.json
cp $GOPATH/src/github.com/mindflavor/goimgshare/shared_folders.json /etc/goimgshare/shared_folders.json

Of course replace /etc/goimgshare with your path. Windows users should use a Windows path of your choosing.

Edit the configuration files

There are two configuration files, one for the general configuration and another for the shared folders.

{
  "Port":8080,
  "CacheInternalHTTPFiles":false,
  "LogInternalHTTPFilesAccess":true,
  "InternalHTTPFilesPath": "D:\\GIT\\Go\\src\\github.com\\mindflavor\\goimgshare",
  "SharedFoldersConfigurationFile":"D:\\temp\\shared_folders.json",
  "ThumbnailCacheFolder":"D:\\temp\\thumbs",
  "SmallThumbnailSize":500,
  "AverageThumbnailSize":1000,
  "Google":{
    "ClientID":"247709547460-aovc4l7ghgs2senq0cr2ivphiu12kssv.apps.googleusercontent.com",
    "Secret":"h7tgEmIMHf6Q-xvQQcP9glmQ",
    "ReturnURL":"http://localhost:8080/auth/google/callback"},
  "Facebook":null,
  "Github":null
}

The attributes are:

As you can see, the authentication providers are optional. Just make sure to specify at least one or you won't be able to log in! 😉.

This is a sample shared folders configuration file:

[
  {
    "ID": "001",
    "Name": "temp on D",
    "Path": "D:\\temp on D",
    "AuthorizedMails": {
      "francesco.cogno@gmail.com": true,
      "valentina.test@gmail.com": true
    }
  },
  {
    "ID": "002",
    "Name": "temp on C",
    "Path": "C:\\temp",
    "AuthorizedMails": {
      "francesco.cogno@gmail.com": true,
      "prova@test.com": true
    }
  }
]

The file is an array of shared folders. The first folder can be viewed - along with its contenints - by francesco.cogno@gmail.com and valentina.test@gmail.com. The second folder is also accessible by francesco.cogno@gmail.com but not by valentina.test@gmail.com. It's the only folder accessible by prova@test.com.

The shared folder fields are:

Build and install the program

go install github.com/mindflavor/goimgshare

This will place the binary in your $GOPATH\bin folder.

Start the program specifying the main configuration file

$GOPATH/bin/goimgshare /etc/goimgshare/config.json

If everything goes as planned (ie there are no bugs and the configuration files are correct) you should see something like this:

And you will be able to browse the http://localhost: address. Since you are not authenticated you will see the authentication page (the number of authentication providers is dependent on the configuration - check the [authentication_providers] section for details):

Here we have Google and Facebook as authentication providers. Note that the links are dynamic and dependent on the configuration (so you won't see a button if you have not configured the relevant provider).

Acknowledgements

This program uses these libraries:

• https://github.com/stretchr/gomniauth
• https://github.com/stretchr/signature
• https://github.com/gorilla/mux
• https://github.com/nfnt/resize
• AngularJS
• Bootstrap

Happy coding

Francesco Cogno