{"id":21421908,"url":"https://github.com/rlancer/super-share","last_synced_at":"2025-07-14T08:30:55.805Z","repository":{"id":62973390,"uuid":"36573910","full_name":"rlancer/super-share","owner":"rlancer","description":"A solution to lengthy Google Drive Sharing URLs ","archived":false,"fork":false,"pushed_at":"2018-06-27T21:17:21.000Z","size":11530,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T04:05:35.336Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://share.robertlancer.com/Super-Share","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rlancer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-30T20:12:01.000Z","updated_at":"2022-05-05T15:58:46.000Z","dependencies_parsed_at":"2022-11-10T05:00:34.018Z","dependency_job_id":null,"html_url":"https://github.com/rlancer/super-share","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/rlancer/super-share","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlancer%2Fsuper-share","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlancer%2Fsuper-share/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlancer%2Fsuper-share/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlancer%2Fsuper-share/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rlancer","download_url":"https://codeload.github.com/rlancer/super-share/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlancer%2Fsuper-share/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265262588,"owners_count":23736422,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T20:40:31.136Z","updated_at":"2025-07-14T08:30:55.462Z","avatar_url":"https://github.com/rlancer.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"Super Share\n=========== \n\n[Super Share Presentation](http://share.robertlancer.com/Super-Share)\n\nSuper Share is a more elegant way to share documents from Google Drive for Google Apps users. \n\nIt deploys to Google App Engine and is designed to be efficient enough to run within App Engine's free daily quota. \n\n**This system automatically changes certain file permissions to include Anyone with the link can view**  \n\n+ share.example.com/file-title URL pattern \n+ Receive alerts for when files are viewed, enabled per a file \n+ Supports partial matches, ie: \"Road\" will match \"RoadTrip.mp4\" \n+ No Google Drive branding \n+ Runs on Google App Engine\n+ Will easily run within the free daily App Engine quota\n+ Open Source with the MIT License. Feel free to fork it and customize it\n\nDemos\n+ [Picture](http://share.robertlancer.com/KoreanBBQ.jpg)\n+ [Spreadsheet](http://share.robertlancer.com/Spreadsheet)\n+ [Video](http://share.robertlancer.com/Roadtrip.mp4)\n+ [PDF](http://share.robertlancer.com/Comic-Book.pdf)\n+ [Google Doc](http://share.robertlancer.com/Press)\n+ [Google Slides](http://share.robertlancer.com/Super-Share)\n\n## Prerequisites\n\n+   [Perform Google Apps Domain-Wide Delegation of Authority](https://developers.google.com/drive/v2/web/delegation)\n+   At a minimum you will need to have the *https://www.googleapis.com/auth/drive* and *https://www.googleapis.com/auth/gmail.compose* scopes enabled  \n+   Create a project in the [Google Cloud Console](http://console.developers.google.com)\n\n## Get the code\n\n    git clone https://github.com/rlancer/super-share.git\n    cd super-share\n\n## Arange your Content\n\n+ Create a folder in Drive\n+ Add in the files you would like to share underneath that folder\n+ Files will automatically have their permission updated to *Anyone with the link* can view\n\n## Add in an appengine-web.xml\n\nCreate the appengine-web.xml underneath the *webapp/WEB-INF* directory. Adjust the properties to match your environment's settings. \n\n```xml\n\u003cappengine-web-app xmlns=\"http://appengine.google.com/ns/1.0\"\u003e\n    \u003capplication\u003ecloud-console-project-id\u003c/application\u003e\n    \u003cversion\u003e1\u003c/version\u003e\n    \u003cthreadsafe\u003etrue\u003c/threadsafe\u003e\n    \u003csessions-enabled\u003efalse\u003c/sessions-enabled\u003e\n    \u003cprecompilation-enabled\u003etrue\u003c/precompilation-enabled\u003e\n    \u003csystem-properties\u003e\n        \u003cproperty name=\"file.encoding\" value=\"UTF-8\"/\u003e\n        \u003cproperty name=\"email\" value=\"email_account_which_owns_the_folder@yourdomain.com\"/\u003e\n        \u003cproperty name=\"folder\" value=\"id_of_folder_which_will_store_the_documents\"/\u003e\n        \u003cproperty name=\"serviceAccountEmailAddress\" value=\"service account email address\"/\u003e\n        \u003cproperty name=\"allowPartialMatches\" value=\"true\"/\u003e\n    \u003c/system-properties\u003e\n\u003c/appengine-web-app\u003e\n```\n\n## Add your Private Key\n\nThe private key comes from performing domain wide delegation of authority\n\nCopy the .p12 file to *src/main/webapp/WEB-INF/privatekey* directory\n\n## Enable View Alert Emails for a File\n\nSimply edit the description field of the file in Drive to include the text *#SSALERT* and \nthe owner will receive an email from themselves when the file is viewed.\nEmails include the IP address and User Agent of the viewer \n\n\n## Run the App Locally\n\n    gradle appengineRun\n\nA local server should be spawned. Visit http://localhost:SERVER_PORT/file-name in your browser. If you see your file displayed then everything works!\n\n## Deploy to App Engine\n\n    gradle appengineUpdate\n\n## Set up your Sub-domain\n\nGenerally we will want our users to visit *shares.our-domain.com/file-name*\n\nTo set this up we will need to go to our Google Apps admin panel and wire up the Super Share app to our domain\n\nLogin to [admin.google.com](https://admin.google.com)\n\nGo to the App Engine section - If you cant see it try clicking on More\n\nNext add your App Engine Id and map it to point to your sub-domain\n\nFollow the setup instructions to wire up your sub-domain in your DNS settings\n\n## Roadmap \n\n+ Support for static HTML websites \n+ Support for downloading files \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlancer%2Fsuper-share","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frlancer%2Fsuper-share","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlancer%2Fsuper-share/lists"}