Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Ranchero-Software/NetNewsWire
RSS reader for macOS and iOS.
https://github.com/Ranchero-Software/NetNewsWire
feed-reader json-feed macos rss rss-feed-reader rss-reader
Last synced: 3 months ago
JSON representation
RSS reader for macOS and iOS.
- Host: GitHub
- URL: https://github.com/Ranchero-Software/NetNewsWire
- Owner: Ranchero-Software
- License: mit
- Created: 2017-05-21T17:59:23.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-08-06T04:35:16.000Z (3 months ago)
- Last Synced: 2024-08-14T19:16:28.602Z (3 months ago)
- Topics: feed-reader, json-feed, macos, rss, rss-feed-reader, rss-reader
- Language: Swift
- Homepage: https://netnewswire.com/
- Size: 38 MB
- Stars: 8,145
- Watchers: 127
- Forks: 518
- Open Issues: 788
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - NetNewsWire - It’s a free and open-source feed reader for macOS and iOS. (Parsing / Other Parsing)
- open-source-mac-os-apps - NetNewsWire - Feed reader for macOS. ![swift_icon] (Applications / News)
- awesome - Ranchero-Software/NetNewsWire - RSS reader for macOS and iOS. (Swift)
- awesome-ios-star - NetNewsWire - It’s a free and open-source feed reader for macOS and iOS. (Parsing / Other Parsing)
- awesome-starred-test - Ranchero-Software/NetNewsWire - RSS reader for macOS and iOS. (Swift)
- fucking-open-source-ios-apps - NetNewsWire - in-JSON formats (News / RSS)
- awesome-hacking-lists - Ranchero-Software/NetNewsWire - RSS reader for macOS and iOS. (Swift)
- awesome-reconsidera-takeaway - NetNewsWire - Source Software][oss icon] – macOS/iOS (工具 / RSS)
- awesome-swift-macos-apps - NetNewsWire - Feed reader for macOS. (News / Text)
- awesome-swift-macos-apps - NetNewsWire - Feed reader for macOS. (News / Text)
- open-source-mac-os-apps - NetNewsWire - Feed reader for macOS. ![swift_icon] (Applications / News)
- my-awesome - Ranchero-Software/NetNewsWire - reader,json-feed,macos,rss,rss-feed-reader,rss-reader pushed_at:2024-10 star:8.3k fork:0.5k RSS reader for macOS and iOS. (Swift)
README
#  NetNewsWire
It’s a free and open-source feed reader for macOS and iOS.
It supports [RSS](https://cyber.harvard.edu/rss/rss.html), [Atom](https://datatracker.ietf.org/doc/html/rfc4287), [JSON Feed](https://jsonfeed.org/), and [RSS-in-JSON](https://github.com/scripting/Scripting-News/blob/master/rss-in-json/README.md) formats.
More info: [https://netnewswire.com/](https://netnewswire.com/)
Also see the [Technotes](Technotes/) and the [Roadmap/Milestones](https://github.com/Ranchero-Software/NetNewsWire/milestones).
Note: NetNewsWire’s Help menu has a bunch of these links, so you don’t have to remember to come back to this page.
Here’s [How to Support NetNewsWire](Technotes/HowToSupportNetNewsWire.markdown). Spoiler: don’t send money. :)
#### Community
[Join the Slack group](https://netnewswire.com/slack) to talk with other NetNewsWire users — and to help out, if you’d like to, by testing, coding, writing, providing feedback, or just helping us think things through. Everybody is welcome and encouraged to join.
Every community member is expected to abide by the [code of conduct](CONTRIBUTING.md#code-of-conduct) which is included in the [Contributing](CONTRIBUTING.md) page.
#### Pull Requests
See the [Contributing](CONTRIBUTING.md) page for our process. It’s pretty straightforward.
#### Building
You can build and test NetNewsWire without a paid developer account.
```bash
git clone https://github.com/Ranchero-Software/NetNewsWire.git
```
You can locally override the Xcode settings for code signing
by creating a `DeveloperSettings.xcconfig` file locally at the appropriate path.
This allows for a pristine project with code signing set up with the appropriate
developer ID and certificates, and for developer to be able to have local settings
without needing to check in anything into source control.
You can do this in one of two ways: using the included `setup.sh` script or by creating the folder structure and file manually.
##### Using `setup.sh`
- Open Terminal and `cd` into the NetNewsWire directory.
- Run this command to ensure you have execution rights for the script: `chmod +x setup.sh`
- Execute the script with the following command: `./setup.sh` and complete the answers.
##### Manually
Make a directory `SharedXcodeSettings` next to where you have this repository.
The directory structure is:
```
aDirectory/
SharedXcodeSettings/
DeveloperSettings.xcconfig
NetNewsWire/
NetNewsWire.xcworkspace
```
Example:
If your NetNewsWire Xcode project file is at:
`/Users/Shared/git/NetNewsWire/NetNewsWire.xcodeproj`
Create your `DeveloperSettings.xcconfig` file at
`/Users/Shared/git/SharedXcodeSettings/DeveloperSettings.xcconfig`
Then create a plain text file in it: `SharedXcodeSettings/DeveloperSettings.xcconfig` and
give it the contents:
```
CODE_SIGN_IDENTITY = Mac Developer
DEVELOPMENT_TEAM =
CODE_SIGN_STYLE = Automatic
ORGANIZATION_IDENTIFIER =
DEVELOPER_ENTITLEMENTS = -dev
PROVISIONING_PROFILE_SPECIFIER =
```
Set `DEVELOPMENT_TEAM` to your Apple supplied development team. You can use Keychain
Access to [find your development team ID](/Technotes/FindingYourDevelopmentTeamID.md).
Set `ORGANIZATION_IDENTIFIER` to a reversed domain name that you control or have made up.
Note that `PROVISIONING_PROFILE_SPECIFIER` should not have a value associated with it.
You can now open the `NetNewsWire.xccodeproj` in Xcode.
Now you should be able to build without code signing errors and without modifying
the NetNewsWire Xcode project. This is a special build of NetNewsWire with some
functionality disabled. This is because we have API keys that can't be stored in the
repository or shared between developers. Certain account types, like Feedly, aren't
enabled and the Reader View isn't enabled because of this.
If you have any problems, we will help you out in Slack ([see above](README.md#Community)).