/Tradit-TPL

Use an HFS 2 'template' in HFS 3 - PRE-ALPHA stage

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Tradit-TPL

Use an HFS 2 'template' in HFS 3 - PRE-ALPHA stage

Features

  • Speed! Always response within 10ms then stream the page
    (without file sorting, though not implemented yet)
  • Different "macro" concept, not interpreted but executed
    (code describes best; or just feel it)

Try it out

For it's way too early, not put to HFS "search online" list yet.

  1. Wait for HFS to release 0.22.3 or later, download & set it up.
    Couldn't wait anymore? Follow its guide to build, not that difficult.
  2. Clone (or download archive of) this repository
  3. Copy the dist folder to HFS plugin folder, rename as Tradit-TPL
  4. Launch HFS, go to admin UI, Plugin panel, enable this plugin
    First start will auto search & use bare.tpl for demo purpose
  5. Go to "Shared Files" panel, put some files/folders
  6. Browse files. See if it works
  7. prepare & go to a folder with music files, and enjoy the music player (will appear at left-bottom corner)

To change template, in Plugin panel, configure this plugin and pick other desired template file.

But currently none of existing templates will work perfectly.

FaQ

Why "Trait-TPL"?
I casually took it from word "traditional". But that word is not the case -- we have new way.
And pronounce that "tra" as in "trap".

Is it secure enough?
Since it's non-production, it yet can't be determined.
But it's certainly true that so-called "injection" won't work!
Leave away from those tech imps. Test your case with good tools like OWASP ZAP, not a mouth.

Dev

  • Prepare: cd to repo, npm install
  • Transpile: npx tsc

Symlinking dist to plugin folder as Tradit-TPL helps.

Under X11 (yes, neither Windows/Wine nor Wayland), HFS can't reload correctly with npx tsc --watch, after 2 times.
Assign a keybinding to your DE (like KDE Plasma) to run touch /<DEV_PATH_HERE>/Tradit-TPL/dist/plugin.js. My choice is Ctrl+Alt+Shift+S.

Far more things are going to be changed, and many macros are not implemented yet.

Don't pay too much attention as for now...

Yawn... Bed time...