A simple image share system in go.
Go HTML JavaScript CSS Makefile
Permalink
Failed to load latest commit information.
api
client
common
plugins [Fix][Readme][TCCOS] guide link error in en version Sep 23, 2016
rikkac
server [Change][HTML] description and add some comment Sep 20, 2016
.gitignore ignore git big picture image file bp.png Sep 7, 2016
CONTRIBUTORS.md [Add] contributors file Sep 14, 2016
DaoCloudDockerfile
Dockerfile
LICENSE
Makefile
README.md
README.zh.md
daocloud.yml
deploy.md
deploy.zh.md [Add][Doc] add a section for use different plugins in deploy doc Sep 11, 2016
entry.go
init.go

README.md

Rikka - A simple image share system

中文版

Rikka is written in Golang primarily, and provide Docker image.

Rikka image has been published to DockerHub, just try it!

Badges above shows latest version and size of Rikka image.

Introduction

Rikka(りっか in Japanese, sound like /ɾʲikka/, not /rikka/)is a integral personal image share system, includes:

  • A web application (See Demo section)
  • A RESTful API server (See API Doc)
  • A CLI tool named Rikkac based on the API (See Rikkac Doc)
  • Image save plugins (See Plugins Doc to get all available plugins)

Other parts not written in Golang (in plan):

  • Andrild client
  • iOS client

Feature and Advantage

  1. Simple and minimalist, no upload history
  2. Image address can be copied to various formats
  3. Many available image save plugins, such as weibo, QinNiu, UPai, Tencent Cloud, etc.
  4. RESTful API provided
  5. Modular Web server and API server
  6. CLI tool provided
  7. Only guarantee support for recent versions of Chrome/Firefox/Safari
  8. Cute homepage image
  9. An active maintainer :)

Demo

There is a Demo site built with Rikka, password is rikka, just try it.

homepage:

homepage

Click Choose button to choose an image.

Input passwordrikka.

Click Upload button.

If no error happened, you will be redirect to preview page:

viewpage

You will see a "Please wait" message If you uploaded a large file and save process is not finished, just wait a second.

When you see image url, you can click Src, Markdown, HTML, RST, BBCode button to copy image url in that format.

But: Once you close this page, you can't get it back except from browser history(Or you save the url).

This is intentional. The main design concept is simple, just Upload-Copy-Close-Patse, then you can forget Rikka.

BTW: The preview image of Demo site is saved in Rikka too.

Plugins

Truly image save back-end of Rikka is written as plugins, can be specified by -plugin option.

Please see Rikka Plugins Doc for available plugins.

API

See Rikka API Doc.

CLI - Rikkac

Rikkac is a CLI tool for Rikka based on Rikka's RESTful API.

Build, install, configure and use guide can be found in Rikkac Doc.

Deploy

Want deploy Rikka system of you own? Check Rikka Deploy Doc for deploy guide.

Contribution

  • Fork me
  • Create a new branch from dev branch
  • Add your code, comment, document and meaningful commit message
  • Add yourself to CONTRIBUTION.md and describe your work
  • PR to dev branch

Thanks all contributors!

You can see a list of contributors in CONTRIBUTIONS.md.

Acknowledgements

  • Thanks Golang and her developers
  • Thanks Visual Studio Code and her developers
  • Thanks open source

License

All code of Rikka system are open source, based on MIT license.

See LICENSE.