pogo/README.md

80 lines
2 KiB
Markdown
Raw Permalink Normal View History

2017-11-23 17:49:58 +00:00
<img src="https://cdn.rawgit.com/gmemstr/pogo/ddc9ff3a/assets/web/static/logo-sm.png" alt="Pogo logo" align="right">
2017-11-20 00:12:16 +00:00
## Pogo
2018-01-09 18:38:27 +00:00
[![Build Status](https://travis-ci.org/gmemstr/pogo.svg?branch=master)](https://travis-ci.org/gmemstr/pogo) [![Demo](https://img.shields.io/badge/demo-demo.pogoapp.net-green.svg)](http://demo.pogoapp.net)
2018-01-19 21:05:16 +00:00
Podcast RSS & JSON feed generator and CMS in Go.
## Getting Started
There are a couple options for getting Pogo up and running.
2017-12-19 05:33:22 +00:00
- [Download the latest release](#running)
2018-01-19 21:05:16 +00:00
- [Use Docker](#docker)
- [Clone the repo and build](#building)
## Features
2017-07-05 08:32:04 +01:00
- Automatic RSS and JSON feed generation
- Frontend for listening and publishing episodes
- Multiple user support
2018-01-09 18:44:43 +00:00
- Simple deployment
- SPA frontend
2018-01-19 21:05:16 +00:00
- Docker support
2017-07-05 08:31:01 +01:00
2017-11-20 00:32:18 +00:00
## Running
2018-01-12 16:44:10 +00:00
[![asciicast](https://asciinema.org/a/GTsDD2nJeLktUAbrQq4hyziOt.png)](https://asciinema.org/a/GTsDD2nJeLktUAbrQq4hyziOt)
2017-11-25 06:05:39 +00:00
2017-11-20 00:32:18 +00:00
1. [Download the latest release](https://github.com/gmemstr/pogo/releases/latest)
2018-01-09 18:44:43 +00:00
2. Run `pogo`
2017-11-20 00:32:18 +00:00
2018-01-19 21:05:16 +00:00
## Docker
[![dockerhub](https://img.shields.io/badge/dockerhub-gmemstr%2Fpogo-blue.svg)](https://hub.docker.com/r/gmemstr/pogo/)
Docker images are based on the `master` branch and built when TravisCI is triggered.
```
docker pull gmemstr/pogo
docker run -p 3000:3000 gmemstr/pogo
```
## Building
2017-06-15 17:23:09 +01:00
_Note: [This requires a valid Go enviornment setup!](https://golang.org/doc/install)_
```
# Go get the repository
go get github.com/gmemstr/pogo
2017-11-20 00:32:18 +00:00
# Go to directory
cd $GOPATH/src/github.com/gmemstr/pogo
2017-11-20 00:32:18 +00:00
# Get godep
go get github.com/tools/godep
2017-11-20 00:32:18 +00:00
# Install Go dependencies
godep restore
2017-11-20 00:32:18 +00:00
# Build
go build
2017-11-20 00:32:18 +00:00
# Run
./pogo
2017-11-20 00:32:18 +00:00
```
2018-01-12 16:56:51 +00:00
[Looking for the web frontend?](https://github.com/gmemstr/pogo-vue).
2017-11-20 00:32:18 +00:00
## Credits
Pogo depends on several other open source projects to function.
- [Golang](https://golang.org/)
- [gorilla/mux](http://github.com/gorilla/mux)
- [gorilla/feeds](http://github.com/gorilla/feeds)
- [fsnotify/fsnotify](http://github.com/fsnotify/fsnotify)
2017-11-23 17:49:58 +00:00
- [mattn/go-sqlite3](http://github.com/mattn/go-sqlite3)