Skip to content

Commit

Permalink
Update Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Vafilor committed Dec 19, 2023
1 parent 6498c3a commit b89cd25
Show file tree
Hide file tree
Showing 4 changed files with 138 additions and 29 deletions.
42 changes: 33 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,36 @@
Introduction
============

Scout is a cross platform File Browser. At the moment, functionality is pretty limited. Try back later.

![Sample video showing file browsing]("/sample/demo.gif")

## Features
* List File names
* Navigate across directories and drives
* View basic image, video, and text files
* Use arrow keys (<- and ->) to navigate files while viewing in a directory

## Why?

Two problems

- [ ] Handle Why 1?

I have a lot of photos on a windows machine in HEIC format. Some folders have thousands of images.
My goal is to organize them into folders like cats, weather, etc. But it takes a while for windows explorer
to generate thumbnails for all of the photos and videos. Worse yet, there's no way (afaik) to trigger the process for all files in a folder - so I have to scroll, wait. Scroll, wait. Directory Opus does a decent job,
but the image cache size seemed to be not working when I tried it last, so the images generated then regenerated later. Maybe this is fixed now.

- [ ] Handle Why 2?

I want to be able to see images and navigate forward/back with arrow keys. Windows 10/11 kinda does this with the default photo app, but sometimes it has a hard time figuring next/previous images. I could swear it worked in Windows 7, but, who knows.

I want to see if I can create an electron program to help me with these problems.

## Sources

Icons are from [Bootstrap](https://icons.getbootstrap.com/)
* Icons are from [Bootstrap](https://icons.getbootstrap.com/). Thanks Bootstrap!

## Next up

Expand All @@ -24,11 +51,8 @@ Icons are from [Bootstrap](https://icons.getbootstrap.com/)
- [ ] Upgrade to tslint strict
- [ ] remove unused packages
- [x] On windows, when you go to root "/", display the list of drives to go to
- [ ] Better Readme with screenshots and gifs



// After this, add a menu with options dropdowns like - view hidden files.
// I want to be able to toggle that.
// After that, work on the image caching and rendering.
// I want to work with HEIC files and mp4 videos - generate thumbnails, cache, etc.
- [ ] Update top menu to indicate current state of file listing mode. Is it table or icons?
- [ ] Update top menu to have dropdowns with options like view hidden files
- [ ] Support image caching for thumbnails of various sizes
- [ ] Choose a file thumbnail size
- [ ] Better Readme with screenshots and gifs
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Binary file added sample/demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
121 changes: 103 additions & 18 deletions yarn.lock
Original file line number Diff line number Diff line change
Expand Up @@ -321,10 +321,10 @@
dependencies:
mime "^3.0.0"

"@cloudflare/workerd-windows-64@1.20231030.0":
"@cloudflare/workerd-darwin-arm64@1.20231030.0":
version "1.20231030.0"
resolved "https://registry.npmjs.org/@cloudflare/workerd-windows-64/-/workerd-windows-64-1.20231030.0.tgz"
integrity sha512-fb/Jgj8Yqy3PO1jLhk7mTrHMkR8jklpbQFud6rL/aMAn5d6MQbaSrYOCjzkKGp0Zng8D2LIzSl+Fc0C9Sggxjg==
resolved "https://registry.npmjs.org/@cloudflare/workerd-darwin-arm64/-/workerd-darwin-arm64-1.20231030.0.tgz"
integrity sha512-WSJJjm11Del4hSneiNB7wTXGtBXI4QMCH9l5qf4iT5PAW8cESGcCmdHtWDWDtGAAGcvmLT04KNvmum92vRKKQQ==

"@cspotcode/source-map-support@^0.8.0":
version "0.8.1"
Expand Down Expand Up @@ -733,20 +733,20 @@
escape-string-regexp "^4.0.0"
rollup-plugin-node-polyfills "^0.2.1"

"@esbuild/win32-x64@0.17.19":
"@esbuild/darwin-arm64@0.17.19":
version "0.17.19"
resolved "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.17.19.tgz"
integrity sha512-lAhycmKnVOuRYNtRtatQR1LPQf2oYCkRGkSFnseDAKPl8lu5SOsK/e1sXe5a0Pc5kHIHe6P2I/ilntNv2xf3cA==
resolved "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.17.19.tgz"
integrity sha512-80wEoCfF/hFKM6WE1FyBHc9SfUblloAWx6FJkFWTWiCoht9Mc0ARGEM47e67W9rI09YoUxJL68WHfDRYEAvOhg==

"@esbuild/win32-x64@0.18.20":
"@esbuild/darwin-arm64@0.18.20":
version "0.18.20"
resolved "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.18.20.tgz"
integrity sha512-kTdfRcSiDfQca/y9QIkng02avJ+NCaQvrMejlsB3RRv5sE9rRoeBPISaZpKxHELzRxZyLvNts1P27W3wV+8geQ==
resolved "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.18.20.tgz"
integrity sha512-bxRHW5kHU38zS2lPTPOyuyTm+S+eobPUnTNkdJEfAddYgEcll4xkT8DB9d2008DtTbl7uJag2HuE5NZAZgnNEA==

"@esbuild/win32-x64@0.19.9":
"@esbuild/darwin-arm64@0.19.9":
version "0.19.9"
resolved "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.19.9.tgz"
integrity sha512-oxoQgglOP7RH6iasDrhY+R/3cHrfwIDvRlT4CGChflq6twk8iENeVvMJjmvBb94Ik1Z+93iGO27err7w6l54GQ==
resolved "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.19.9.tgz"
integrity sha512-KBJ9S0AFyLVx2E5D8W0vExqRW01WqRtczUZ8NRu+Pi+87opZn5tL4Y0xT0mA4FtHctd0ZgwNoN639fUUGlNIWw==

"@eslint-community/eslint-utils@^4.2.0":
version "4.4.0"
Expand Down Expand Up @@ -1079,6 +1079,11 @@
js-base64 "^3.7.5"
libsql "^0.2.0-pre.4"

"@libsql/[email protected]":
version "0.2.0-pre.5"
resolved "https://registry.npmjs.org/@libsql/darwin-arm64/-/darwin-arm64-0.2.0-pre.5.tgz"
integrity sha512-qHRIz+zztq7mfkfAhjkZvHTLLofffAydWcHdUH2B8q/HzAQUL18jswKwHY+Fo1RAyofPXyfUOW7uIsF1yTEQBg==

"@libsql/hrana-client@^0.5.5":
version "0.5.5"
resolved "https://registry.npmjs.org/@libsql/hrana-client/-/hrana-client-0.5.5.tgz"
Expand All @@ -1105,11 +1110,6 @@
"@types/ws" "^8.5.4"
ws "^8.13.0"

"@libsql/[email protected]":
version "0.2.0-pre.5"
resolved "https://registry.npmjs.org/@libsql/win32-x64-msvc/-/win32-x64-msvc-0.2.0-pre.5.tgz"
integrity sha512-tJnFGOXFU2fNbnyCFx8d3OHV2x8GHc/RNRooyAUrclOrM7RiBd1znwChLTlEnkgqaabgKeLknZOHzq0dJtBfFg==

"@malept/cross-spawn-promise@^1.0.0":
version "1.1.1"
resolved "https://registry.npmjs.org/@malept/cross-spawn-promise/-/cross-spawn-promise-1.1.1.tgz"
Expand Down Expand Up @@ -3386,6 +3386,50 @@ [email protected]:
resolved "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz"
integrity sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==

electron-installer-common@^0.10.2:
version "0.10.3"
resolved "https://registry.npmjs.org/electron-installer-common/-/electron-installer-common-0.10.3.tgz"
integrity sha512-mYbP+6i+nHMIm0WZHXgGdmmXMe+KXncl6jZYQNcCF9C1WsNA9C5SZ2VP4TLQMSIoFO+X4ugkMEA5uld1bmyEvA==
dependencies:
"@malept/cross-spawn-promise" "^1.0.0"
asar "^3.0.0"
debug "^4.1.1"
fs-extra "^9.0.0"
glob "^7.1.4"
lodash "^4.17.15"
parse-author "^2.0.0"
semver "^7.1.1"
tmp-promise "^3.0.2"
optionalDependencies:
"@types/fs-extra" "^9.0.1"

electron-installer-debian@^3.2.0:
version "3.2.0"
resolved "https://registry.npmjs.org/electron-installer-debian/-/electron-installer-debian-3.2.0.tgz"
integrity sha512-58ZrlJ1HQY80VucsEIG9tQ//HrTlG6sfofA3nRGr6TmkX661uJyu4cMPPh6kXW+aHdq/7+q25KyQhDrXvRL7jw==
dependencies:
"@malept/cross-spawn-promise" "^1.0.0"
debug "^4.1.1"
electron-installer-common "^0.10.2"
fs-extra "^9.0.0"
get-folder-size "^2.0.1"
lodash "^4.17.4"
word-wrap "^1.2.3"
yargs "^16.0.2"

electron-installer-redhat@^3.2.0:
version "3.4.0"
resolved "https://registry.npmjs.org/electron-installer-redhat/-/electron-installer-redhat-3.4.0.tgz"
integrity sha512-gEISr3U32Sgtj+fjxUAlSDo3wyGGq6OBx7rF5UdpIgbnpUvMN4W5uYb0ThpnAZ42VEJh/3aODQXHbFS4f5J3Iw==
dependencies:
"@malept/cross-spawn-promise" "^1.0.0"
debug "^4.1.1"
electron-installer-common "^0.10.2"
fs-extra "^9.0.0"
lodash "^4.17.15"
word-wrap "^1.2.3"
yargs "^16.0.2"

electron-squirrel-startup@^1.0.0:
version "1.0.0"
resolved "https://registry.npmjs.org/electron-squirrel-startup/-/electron-squirrel-startup-1.0.0.tgz"
Expand Down Expand Up @@ -4354,6 +4398,11 @@ fs.realpath@^1.0.0:
resolved "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz"
integrity sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==

fsevents@^2.3.2, fsevents@~2.3.2:
version "2.3.3"
resolved "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz"
integrity sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==

fswin@^3.23.311:
version "3.23.311"
resolved "https://registry.npmjs.org/fswin/-/fswin-3.23.311.tgz"
Expand Down Expand Up @@ -4388,6 +4437,11 @@ galactus@^1.0.0:
flora-colossus "^2.0.0"
fs-extra "^10.1.0"

gar@^1.0.4:
version "1.0.4"
resolved "https://registry.npmjs.org/gar/-/gar-1.0.4.tgz"
integrity sha512-w4n9cPWyP7aHxKxYHFQMegj7WIAsL/YX/C4Bs5Rr8s1H9M1rNtRWRsw+ovYMkXDQ5S4ZbYHsHAPmevPjPgw44w==

gauge@^4.0.3:
version "4.0.4"
resolved "https://registry.npmjs.org/gauge/-/gauge-4.0.4.tgz"
Expand All @@ -4412,6 +4466,14 @@ get-caller-file@^2.0.5:
resolved "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz"
integrity sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==

get-folder-size@^2.0.1:
version "2.0.1"
resolved "https://registry.npmjs.org/get-folder-size/-/get-folder-size-2.0.1.tgz"
integrity sha512-+CEb+GDCM7tkOS2wdMKTn9vU7DgnKUTuDlehkNJKNSovdCOVxs14OfKCk4cvSaR3za4gj+OBdl9opPN9xrJ0zA==
dependencies:
gar "^1.0.4"
tiny-each-async "2.0.3"

get-installed-path@^2.0.3:
version "2.1.1"
resolved "https://registry.npmjs.org/get-installed-path/-/get-installed-path-2.1.1.tgz"
Expand Down Expand Up @@ -5956,7 +6018,7 @@ lodash.throttle@^4.1.1:
resolved "https://registry.npmjs.org/lodash.throttle/-/lodash.throttle-4.1.1.tgz"
integrity sha512-wIkUCfVKpVsWo3JSZlc+8MB5it+2AN5W8J7YVMST30UrvcQNZ1Okbj+rbVniijTWE6FGYy4XJq/rHkas8qJMLQ==

lodash@^4.17.15, lodash@^4.17.20, lodash@^4.17.21:
lodash@^4.17.15, lodash@^4.17.20, lodash@^4.17.21, lodash@^4.17.4:
version "4.17.21"
resolved "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz"
integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==
Expand Down Expand Up @@ -8304,6 +8366,11 @@ timers-ext@^0.1.7:
es5-ext "~0.10.46"
next-tick "1"

[email protected]:
version "2.0.3"
resolved "https://registry.npmjs.org/tiny-each-async/-/tiny-each-async-2.0.3.tgz"
integrity sha512-5ROII7nElnAirvFn8g7H7MtpfV1daMcyfTGQwsn/x2VtyV+VPiO5CjReCJtWLvoKTDEDmZocf3cNPraiMnBXLA==

tmp-promise@^3.0.2:
version "3.0.3"
resolved "https://registry.npmjs.org/tmp-promise/-/tmp-promise-3.0.3.tgz"
Expand Down Expand Up @@ -8857,6 +8924,11 @@ wildcard@^2.0.0:
resolved "https://registry.npmjs.org/wildcard/-/wildcard-2.0.1.tgz"
integrity sha512-CC1bOL87PIWSBhDcTrdeLo6eGT7mCFtrg0uIJtqJUFyK+eJnzl8A1niH56uu7KMa5XFrtiV+AQuHO3n7DsHnLQ==

word-wrap@^1.2.3:
version "1.2.5"
resolved "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz"
integrity sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==

wordwrap@>=0.0.2:
version "1.0.0"
resolved "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz"
Expand Down Expand Up @@ -8996,6 +9068,19 @@ yargs-parser@^21.0.1, yargs-parser@^21.1.1:
resolved "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz"
integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==

yargs@^16.0.2:
version "16.2.0"
resolved "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz"
integrity sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==
dependencies:
cliui "^7.0.2"
escalade "^3.1.1"
get-caller-file "^2.0.5"
require-directory "^2.1.1"
string-width "^4.2.0"
y18n "^5.0.5"
yargs-parser "^20.2.2"

yargs@^17.0.1:
version "17.7.2"
resolved "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz"
Expand Down

0 comments on commit b89cd25

Please sign in to comment.