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 REST 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):
- Android client
- iOS client
Feature and Advantage
- Simple and minimalist, no upload history
- Image address can be copied to various formats
- Many available image save plugins, such as weibo, QinNiu, UPai, Tencent Cloud, etc.
- REST API provided
- Modular Web server and API server
- CLI tool provided
- Only guarantee support for recent versions of Chrome/Firefox/Safari
- Cute homepage image
- An active maintainer :)
Demo
There is a Demo site built with Rikka, password is Because the free docker service provider I used stop it's free plan, the demo is on my personal VPS now. So the password is not given anymore, but you can also visit it and have a look :)rikka
, just try it.
homepage:
Click Choose
button to choose an image.
Input passwordrikka
.
Click Upload
button.
If no error happened, you will be redirect to preview page:
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-Paste
, then you can forget Rikka.
BTW: The preview image of Demo site is saved in Rikka too. (But Github will put images which in Markdown files into its own CDN to accelerate access)
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 REST 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.