https://github.com/timonus/Rhea

A Mac status bar app for quickly sharing files and links.
https://github.com/timonus/Rhea

dropbox mac macos macosx objective-c statusbarutil

Last synced: about 1 month ago
JSON representation

A Mac status bar app for quickly sharing files and links.

• Host: GitHub
• URL: https://github.com/timonus/Rhea
• Owner: timonus
• License: mit
• Created: 2016-08-18T03:27:23.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2024-07-25T01:46:58.000Z (5 months ago)
• Last Synced: 2024-08-01T16:52:01.820Z (4 months ago)
• Topics: dropbox, mac, macos, macosx, objective-c, statusbarutil
• Language: Objective-C
• Homepage:
• Size: 312 KB
• Stars: 91
• Watchers: 8
• Forks: 13
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• open-source-mac-os-apps - Rhea - macOS status bar app for quickly sharing files and URLs. ![objective_c_icon] (Applications / Sharing Files)
• Mac-Menubar-Megalist - Rhea
• open-source-mac-os-apps - Rhea - macOS status bar app for quickly sharing files and URLs. ![objective_c_icon] (Applications / Sharing Files)

README

        
# Rhea

[![](https://dl.dropboxusercontent.com/s/ic4r48xv2ru5r3l/4ba5c0bcdbdf7d79eb87a72f42f16f72-12wH.jpg?dl=0)](https://en.wikipedia.org/wiki/Rhea_(moon))

Rhea is a status bar utility for the Mac that allows you to quickly and easily upload files and shorten links, similar to [CloudApp](https://www.getcloudapp.com/) and [Dropshare](https://dropshare.app). It uses [Dropbox](https://www.dropbox.com/developers) (powered by [TJDropbox](https://github.com/timonus/TJDropbox)) for file storage and [Bitly](https://dev.bitly.com) for shortening links.

## File Upload

You can drag files into the status bar to upload them to Rhea.

![](https://dl.dropboxusercontent.com/s/g9drnbw4rpr9ytt/1-vC9R.gif?dl=0)

Or, if you have a file path or file URL copied to your clipboard you can upload it via Rhea’s dropdown menu.

![](https://dl.dropboxusercontent.com/s/ae44aa9z4p9a3ig/2-bxlw.gif?dl=0)

Dropbox links are copied to the clipboard while files are being uploaded in the background, so it’s very quick.

### Technical Notes

- The API one uses to copy a link while an upload is occurring is deprecated by Dropbox. May have to move to another endpoint at some point.

- A 4-character base 62 suffix is appended to all uploaded files to avoid filename conflicts. This suffix is consistent for a given file's contents, so repeat uploads of the same file with the same filename act as no-ops.

- It is recommended that you use Dropbox’s [selective sync](https://www.dropbox.com/en/help/175) feature to disable the Rhea directory from being synched to your Mac.

## Link Shortening

You can drag links into the status bar to shorten them.

![](https://dl.dropboxusercontent.com/s/8sgrwkzcnib5isl/3-JqyP.gif?dl=0)

Or, if you have a URL copied to your clipboard you can shorten it via Rhea’s dropdown menu.

![](https://dl.dropboxusercontent.com/s/yo2brd16yl7q91k/4-6ql9.gif?dl=0)

## Development

- Rhea is open source, however the Dropbox and Bitly API keys needed for it to run aren’t present in the open source repo. In order to develop Rhea you’ll need to provide these keys by doing the following:

	- Fill in `_dropboxAppKey` and add a URL scheme with the format `db-yourDropboxAppKey` to your info.plist's entry for `CFBundleURLTypes` for Dropbox auth.

	- Fill in `_bitlyClientIdentifier`, `_bitlyClientSecret`, and add `rhea-bitly-auth://bitlyauth` as a whitelisted redirect URI in your Bitly app's OAuth app settings for Bitly auth.

- Rhea uses [git submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules), so run `git submodule update --init` when cloning.