1
0
Fork 0
mirror of https://github.com/sbrl/PolyFeed.git synced 2024-11-15 05:23:00 +00:00
PolyFeed/README.md

44 lines
1.7 KiB
Markdown

# PolyFeed
> Create Atom feeds for websites that don't support it
PolyFeed generates Atom feeds out of websites that don't have one, such as _Twitter_ or _Facebook_ (* cough * * cough *). It supports any platform that C♯ .NET applications can run, including Linux and Windows.
## Install
### From a Release
Download and extract the [latest release](https://github.com/sbrl/PolyFeed/releases/latest). You're done!
### Building from Source
Clone this repository, and then build the code with `msbuild`:
```bash
msbuild /p:Configuration=Release
```
The build output will be outputted to `PolyFeed/bin/Release`.
## Usage
PolyFeed uses [TOML](https://github.com/toml-lang/toml) configuration files to define Atom feeds. First, create a configuration file that specifies how PolyFeed should generate an Atom feed - or use [one of the examples](https://github.com/sbrl/PolyFeed/tree/master/examples).
Then, run PolyFeed over it:
```bash
path/to/PolyFeed.exe --config path/to/config.toml
```
...it will generate the named `.atom` file automatically, keeping you up-to-date on it's progress and any errors it encounters.
Use `PolyFeed.exe --help` to display the full range of command-line flags available.
## Contributing
Contributions are welcome - feel free to [open an issue](https://github.com/sbrl/PolyFeed/issues/new) or (even better) a [pull request](https://github.com/sbrl/PolyFeed/compare).
The [issue tracker](https://github.com/sbrl/PolyFeed/issues) is the place where all the tasks relating to the project are kept.
## Licence
PolyFeed is released under the _Mozilla Public License 2.0_. The full license text is included in the `LICENSE` file in this repository.