Table of Contents generated with DocToc

• Getting started - Prebuilt binaries
• Notifications and canceling uploads
• Screenshotting areas or windows
• Feature progress
• Getting started - Building from the source
• Plugins
• Using a Plugin
• Writing a Plugin
• Documentation

ShareNix is a ShareX clone for Linux. It features image/screenshot and file uploading to almost any file/image sharing service that has an API thanks to the easily customizable json configuration.

ShareNix uses the same configuration format as ShareX. If you're a ShareX user, you can easily import your settings by pasting them in the Services section of sharenix.json.

Demonstration video.

Getting started - Prebuilt binaries

The newest binaries are statically built against musl libc and gtk+2.0 and should require no dependencies.

tar xvf sharenix-*.tar.xz
sudo cp sharenix-*/sharenix /usr/bin
sudo chmod +x /usr/bin/sharenix
cp sharenix-*/sharenix.json ~/.sharenix.json
sharenix -h

You can now set-up sharenix any way you like: bind it to hotkeys, launch it from your terminal, and so on.

Check out the sharenix.json config file for the example configuration. I might document the config format some day, but the behaviour is nearly the same as ShareX so you could just read through this section of the ShareX guide.

sharenix.json locations, from highest to lowest priority:

~/.sharenix.json
(base path to sharenix's executable)/sharenix.json
/etc/sharenix.json

The first config file that is found, starting from top to bottom, will be used.

Notifications and canceling uploads

Using the -n flag will enable notifications for uploads in the bottom right corner of your screen.

Right-clicking a "upload in progress" notification will cancel the upload and dismiss the notification.

Right-click a "upload completed" notification will dimiss it, while left clicking the url will open it in your default browser.

If for whatever reason notification positions get buggy, reset the locks by running:

rm ~/sharenix/.notify*

Screenshotting areas or windows

Until window and area grabbing are built into sharenix, you can use pretty much any screenshotting tool and pass its image to sharenix.

If you have xfce4-screenshooter, you can use xfce4-screenshooter -r -o "sharenix -n" for regions and xfce4-screenshooter -w -o "sharenix -n" for windows.

As a more generic solution, I have written two glue scripts that query xfce4-screenshooter, gnome-screenshot and scrot and automatically pass the result to sharenix for uploading.

wget https://raw.githubusercontent.com/Francesco149/sharenix/master/sharenix-section
wget https://raw.githubusercontent.com/Francesco149/sharenix/master/sharenix-window
chmod +x sharenix-*

Now you can bind these scripts to hotkeys using whatever configuration your DE/Window Manager has.

JWM example config (~/.jwmrc):

<Key mask="CS" key="2">exec:sharenix -m="fs" -n -o</Key>
<Key mask="CS" key="3">exec:/path/to/sharenix-window</Key>
<Key mask="CS" key="4">exec:/path/to/sharenix-section</Key>
<Key mask="CS" key="5">exec:sharenix -m="c" -n</Key>
<Key mask="CS" key="i">exec:sharenix -m="c" -n -s="twitter (gweet)"</Key>

i3wm example config (~/.i3/config):

bindsym Ctrl+Shift+2 exec sharenix -m="fs" -n -o
bindsym Ctrl+Shift+3 exec /path/to/sharenix-window
bindsym Ctrl+Shift+4 exec /path/to/sharenix-section
bindsym Ctrl+Shift+5 exec sharenix -m="c" -n
bindsym Ctrl+Shift+i exec sharenix -m="c" -s="twitter" -n

fluxbox example config (~/.fluxbox/keys):

Control Shift 2 :Exec sharenix -m="fs" -n -o
Control Shift 3 :Exec /path/to/sharenix-window
Control Shift 4 :Exec /path/to/sharenix-section
Control Shift 5 :Exec sharenix -m="c" -n
Control Shift i :Exec sharenix -m="c" -n -s="twitter (gweet)"

On ubuntu and similar distros, you can bind them to hotkeys in CompizConfig Settings Manager under commands like so:

Feature progress

• Parsing ShareX's json config - done
• Parsing regexp tags - done (no named groups)
• Parsing tags in the parameters - done
• JSON syntax $json:some.json.field$ - done
• XML syntax $xml:/root/some/xml/field$ - done (untested)
• Custom Headers - done
• File upload - done (./sharenix path/to/file)
• Full-screen screenshot - done (./sharenix -m=fs)
• Upload files and images from clipboard - done (./sharenix -m=c)
• Automatically open uploads in browser if requested - done (-o flag)
• Archiving clipboard and screenshot uploads to a local folder - done (saved in ~/sharenix/archive/)
• Plugin system - done (still very early)
• Upload multiple files from clipboard - WIP
• Upload text from clipboard - done
• URL shortening - done
• Screen region selection - WIP
• Upload progress bar - WIP
• Basic upload history csv file - done (./sharenix -history)
• Grep-able upload history output - done (./sharenix -history | grep helloworld)
• GUI tools for config & history - WIP
• Clickable GTK notifications - done (-n flag)
• Screen recording - WIP

Getting started - Building from the source

NOTE: this codebase is quite outdated (it was written back in go 1.4 or something like that). I don't plan on refactoring the code for now. If you encounter issues while trying to compile it, please downgrade to go 1.7.1 or earlier.

Before we start building ShareNix, you will need to set up a few dependencies.

• Make sure that you have gtk 2.0.
• Get the dev headers for glib, cairo, pango and gtk2. On Ubuntu 15.04, the required packages are: libglib2.0-dev, libcairo-dev, libpango1.0-dev and libgtk-2-dev.
• Make sure that you have go >=1.3.1

It should be possible to automatically get all the dependencies by simply running:

go get github.com/Francesco149/sharenix

If you get any errors, try getting the dependencies individually:

go get github.com/mattn/go-gtk/gtk
go get github.com/BurntSushi/xgb
go get mvdan.cc/xurls
go get github.com/ChrisTrenkamp/goxpath
go get github.com/NodePrime/jsonpath
go get github.com/Francesco149/sharenix

You can also manually clone the repository anywhere you want by running

git clone https://github.com/Francesco149/sharenix.git

To build sharenix, simply run

go install github.com/Francesco149/sharenix

and copy the default config file to $GOPATH/bin

cp $GOPATH/src/github.com/Francesco149/sharenix/sharenix.json $GOPATH/bin/sharenix.json

then run it (in this example I'm going to be uploading a full-screen screenshot to the default site)

cd $GOPATH/bin
./sharenix -m=fs

Plugins

Sharenix has a very early form of plugins as of 0.3.0a. Feel free to contact me if you wrote a plugin and want it in this list, but be advised that the plugin specification is still subject to changes.

• gweet: Upload to twitter

Using a Plugin

Plugins come as one executable but might also include some extra files.

Plugin authors are highly advised to provide specific install instructions for their plugin. I will however provide generic guidelines in this section that will usually apply to every plugin to a certain extent.

To install a plugin, all you have to do is copy all the plugin's files to ~/sharenix/plugins. If the plugins directory doesn't exist, create it.

The plugin authors should always provide an example sharenix.json config entry, or at least a list of parameters you can use. For a generic example of a config entry, see the last step of "Writing a Plugin".

Writing a Plugin

Sharenix has a very early and basic plugin system that might be subject to changes as the development progress.

• Each plugin is a stand-alone executable that will be placed in the ~/sharenix/plugins directory.

• The last line of the combined stdout & stderr output is used and parsed as the plugin's output.

• Command-line parameters must be go-style.

• The plugin will recieve the sharenix.json Arguments list as command-line parameters. Additionally, a special _tail parameter can be used to append anonymous arguments at the end of the argument list.

• The sharenix.json config entry should have this format:

    {
        "Name": "My Awesome Plugin!",
        "RequestType": "PLUGIN",
        "RequestURL": "executable-name",
        "FileFormName": "",
        "Arguments": {
            "_tail": "$input$",
            "foo": "bar",
            "someflag": "true"
        },
        "ResponseType": "Text",
        "RegexList": [],
        "URL": "",
        "ThumbnailURL": "",
        "DeletionURL": ""
    },
  

  which will call executable-name like so:

  executable-name -foo=bar -someflag=true /path/to/file or http://url/to/shorten
  

I am well aware that this plugin system lacks security, but defending yourself from malicious plugins is not hard. Avoid non-opensource plugins at all costs and if in doubt, ask someone to check a plugin's code or check it yourself.

Documentation

To see a list of the available options, run ./sharenix -h

You can get the code documentation with the built-in godoc

godoc github.com/Francesco149/sharenix

If you're looking for a specific function or type just use

godoc github.com/Francesco149/sharenix MyFunction