/NetNewsWire

RSS reader for macOS and iOS.

Primary LanguageSwiftMIT LicenseMIT

Icon NetNewsWire

It’s a free and open-source feed reader for macOS and iOS.

It supports RSS, Atom, JSON Feed, and RSS-in-JSON formats.

More info: https://netnewswire.com/

Also see the Technotes and the Roadmap.

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. Spoiler: don’t send money. :)

Community

Join the Slack group 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 which is included in the Contributing page.

Pull Requests

See the Contributing page for our process. It’s pretty straightforward.

Building

You can build and test NetNewsWire without a paid developer account.

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 = <Your Team ID>
CODE_SIGN_STYLE = Automatic
ORGANIZATION_IDENTIFIER = <Your Domain Name Reversed>
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. 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 iCloud and 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).