Skip to content

zichy/vicco

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

vicco

vicco is brutalist linkblog software contained in a single PHP file.

Features

  • Responsive layout
  • Web interface to publish, edit, and delete posts
  • Text formatting
  • Atom feed
  • No ActivityPub support

Target audiences

  • Hackers — It’s easy to customize.
  • Hipsters — It’s crappy, you could use it as a joke.

Requirements

  • Web server with PHP
  • SSL/TLS certificate

Installation

  1. Adjust the config in index.php, especially your credentials.
  2. Upload it to your server and make the directory writable.
  3. Open the site in your browser.
  4. It should work.

Text formatting

There is some Markdown-inspired formatting. No block elements, though.

Input Output
**strong** / __strong__ strong
*italic* / _italic_ italic
~delete~ delete
:"quote": quote
@code@ code
[https://example.org] https://example.org
[title](https://example.org) title

FAQ

Are there any dependencies? Should I use Composer?
There are no dependencies. This is literally one PHP file.

One single file? How does this work?
Well, actually several files are created in the folder /vicco/, which serves as some kind of rudimentary flat-file database. All posts are stored in JSON.

Can I rename index.php?
You can, but the question is whether you should. (You shouldn’t.)

How did this software come to be?
I forked this script and improved it for the worse.

Uh… follow-up question: Is vicco secure?
It should be secure enough to run a crappy linkblog.

Testimonials

Send me a PR if you want to add yours!

I’m a huge fan of your blog, but I get the creeps from the PHP code.
sternenseemann

cute readme
riotbib

License

vicco is licensed under the BSD-2-Clause license.