https://github.com/shaharia-lab/headlines
Collect news headlines from different news sources
https://github.com/shaharia-lab/headlines
news news-headlines newsapi newspaper
Last synced: 6 months ago
JSON representation
Collect news headlines from different news sources
- Host: GitHub
- URL: https://github.com/shaharia-lab/headlines
- Owner: shaharia-lab
- License: mit
- Created: 2024-08-06T12:05:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-26T07:56:18.000Z (about 1 year ago)
- Last Synced: 2025-03-27T13:55:59.521Z (7 months ago)
- Topics: news, news-headlines, newsapi, newspaper
- Language: Go
- Homepage: https://github.com/shaharia-lab/headlines
- Size: 25.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# headlines
A simple tool to fetch news headlines from different news sources.
## Features
- REST Api endpoints. See the OpenAPI schema [here](https://github.com/shaharia-lab/headlines/blob/main/openapi.yaml).
- A basic UI to see the headlines
## Installation
### Using Docker
Get the latest version from the [release page](https://github.com/shaharia-lab/headlines/releases)
```bash
docker run -p 8081:8080 ghcr.io/shaharia-lab/headlines:{VERSION}
```
### Using Binary
Download the binary from the [release page](https://github.com/shaharia-lab/headlines/releases)
### Run from source
Please clone the repository and run the following command.
```bash
go run . -port 8080
```
Please go to http://localhost:8080 to see the UI.
## Contribution
It's very easy to add more news sources. Feel free to create a PR or. If you have any issues, please feel free to submit an issue [here](https://github.com/shaharia-lab/headlines/issues).
## License
Please see the license [here](https://github.com/shaharia-lab/headlines/blob/main/LICENSE).