ShareRenamer

This Nextcloud app allows you to customize your share tokens, so your links can be like https://your-nextcloud.com/s/mysharedlink instead of https://your-nextcloud.com/s/qPv1SwbU5M2YEoJZ. Just share a file or folder normally and customize the link in the sharerenamer tab in the sidebar.

A simple Nextcloud app that lets you customize file/folder share links

Requirements

• Nextcloud 24 - 26

Installation

Nextcloud app store (recommended)

Just install the app from the Nextcloud app store. It can be found under the 'tools' category.

Manual installation

• Download the latest version from the release page.
• Extract the archive to your Nextcloud's app folder, e.g. tar xvf sharerenamer-x.x.x.tar.gz -C /path/to/nextcloud/apps
• Enable the app in the Apps section of your Nextcloud.

Install from git

• Simply clone the repo to your apps folder and build the frontend:

cd /path/to/nextcloud/apps/
git clone https://github.com/JonathanTreffler/sharerenamer.git
cd sharerenamer/
make composer
make npm-init
make build-js-production

• Enable the app in the Apps section of your Nextcloud.

Security

• Share Tokens can currently not be set to the same string as any registered username, so do not use this app if users are not supposed to be able to find out any other registered usernames.
• Links could be guessed! We discourage using this app on large instances that host sensitive data! We also encourage you to password protect such shared links.

Known Issues:

• Changes to the link shares only show up in the Sharerenamer Tab after the sidebar has been closed and opened again
• The copy button of the Shares tab only copies the new link after the sidebar has been closed and opened again

(please don't create issue for these)

Development

It will automatically spin up and configure a full Nextcloud, MariaDB and PhpMyAdmin server.

Nextcloud Login:

Username: dev

Password: t2qQ1C6ktYUv7

PhpMyAdmin Login:

Username: nextcloud

Password: wdGq73jQB0p373gLdf6yLRj5

OCC

docker exec -it -u 33 gitpod_app_1 php occ

(It is fine to have these static logins, because gitpod has acess control built in and no sensitive data is stored in these dev servers)

Creating a new Release

Steps:

1. Place appstore private key at $HOME/.nextcloud/certificates/sharerenamer.key (/home/gitpod/.nextcloud/certificates/sharerenamer.key for gitpod)
2. krankerl login --appstore <appstore api key>
3. Bump app version using krankerl version (major|minor|patch)
4. Add app update information to CHANGELOG.md
5. Commit app version bump (git commit -m "Bumped app version to <version>")
6. Push commit to Github (git push)
7. krankerl package
8. krankerl sign --package
9. Create a new Github release and attach the build/artifacts/sharerenamer.tar.gz file
10. krankerl publish <github release attached file public url>