📦➔🦋 Store and retrieve files on the Atmosphere
various
+32
-17
+32
-17
atfile.sh
+32
-17
atfile.sh
···
184
184
didplc_doc="$(atfile.util.get_didplc_doc.request_doc "$didplc_endpoint" "$actor")"
185
185
186
186
if [[ "$didplc_doc" != "{"* ]]; then
187
-
didplc_endpoint="https://plc.directory"
187
+
didplc_endpoint="$_endpoint_plc_directory_fallback"
188
188
didplc_doc="$(atfile.util.get_didplc_doc.request_doc "$didplc_endpoint" "$actor")"
189
189
fi
190
190
···
2163
2163
Get details for <actor>
2164
2164
2165
2165
stream <collection>
2166
-
Stream records from JetStream"
2166
+
Stream records from Jetstream"
2167
2167
fi
2168
2168
2169
2169
usage_envvars="${_envvar_prefix}_USERNAME <string> (required)
···
2172
2172
Password of the PDS user
2173
2173
An App Password is recommended (https://bsky.app/settings/app-passwords)
2174
2174
2175
-
${_envvar_prefix}_INCLUDE_FINGERPRINT <bool*> (default: $_include_fingerprint_default)
2175
+
${_envvar_prefix}_INCLUDE_FINGERPRINT <bool¹> (default: $_include_fingerprint_default)
2176
2176
Apply machine fingerprint to uploaded files
2177
-
${_envvar_prefix}_OUTPUT_JSON <bool> (default: $_output_json_default)
2177
+
${_envvar_prefix}_OUTPUT_JSON <bool¹> (default: $_output_json_default)
2178
2178
Print all commands (and errors) as JSON
2179
2179
⚠️ When sourcing, sets to 1
2180
2180
${_envvar_prefix}_MAX_LIST <int> (default: $_max_list_default)
···
2190
2190
Format for fetched filenames. Fragments:
2191
2191
* [key]: Record key of uploaded file
2192
2192
* [name]: Original name of uploaded file
2193
-
${_envvar_prefix}_SKIP_AUTH_CHECK <bool*> (default: $_skip_auth_check_default)
2193
+
${_envvar_prefix}_SKIP_AUTH_CHECK <bool¹> (default: $_skip_auth_check_default)
2194
2194
Skip session validation on startup
2195
2195
If you're confident your credentials are correct, and \$${_envvar_prefix}_USERNAME
2196
2196
is a DID (*not* a handle), this will drastically improve performance!
2197
-
${_envvar_prefix}_SKIP_COPYRIGHT_WARN <bool*> (default: $_skip_copyright_warn_default)
2197
+
${_envvar_prefix}_SKIP_COPYRIGHT_WARN <bool¹> (default: $_skip_copyright_warn_default)
2198
2198
Do not print copyright warning when uploading files to
2199
2199
https://bsky.social
2200
-
${_envvar_prefix}_SKIP_NI_EXIFTOOL <bool*> (default: $_skip_ni_exiftool_default)
2200
+
${_envvar_prefix}_SKIP_NI_EXIFTOOL <bool¹> (default: $_skip_ni_exiftool_default)
2201
2201
Do not check if ExifTool is installed
2202
2202
⚠️ If Exiftool is not installed, the relevant metadata records will
2203
2203
not be created:
2204
2204
* image/*: $_nsid_meta#photo
2205
-
${_envvar_prefix}_SKIP_NI_MEDIAINFO <bool*> (default: $_skip_ni_mediainfo_default)
2205
+
${_envvar_prefix}_SKIP_NI_MEDIAINFO <bool¹> (default: $_skip_ni_mediainfo_default)
2206
2206
Do not check if MediaInfo is installed
2207
2207
⚠️ If MediaInfo is not installed, the relevant metadata records will
2208
2208
not be created:
2209
2209
* audio/*: $_nsid_meta#audio
2210
2210
* video/*: $_nsid_meta#video
2211
2211
2212
+
${_envvar_prefix}_ENDPOINT_JETSTREAM <url> (default: $_endpoint_jetstream_default)
2213
+
Endpoint of the Jetstream relay
2212
2214
${_envvar_prefix}_ENDPOINT_PDS <url>
2213
2215
Endpoint of the PDS
2214
2216
ℹ️ Your PDS is resolved from your username. Set to override it (or if
2215
2217
resolving fails)
2216
-
${_envvar_prefix}_ENDPOINT_PLC_DIRECTORY <url> (default: $_endpoint_plc_directory_default)
2217
-
Endpoint of PLC directory
2218
-
${_envvar_prefix}_ENDPOINT_RESOLVE_HANDLE <url> (default: $_endpoint_resolve_handle_default)
2219
-
Endpoint used for handle resolving
2220
-
ℹ️ Default value is a PDS ran by @ducky.ws and @astra.blue. You can
2221
-
trust us!
2218
+
${_envvar_prefix}_ENDPOINT_PLC_DIRECTORY <url> (default: ${_endpoint_plc_directory_default}$([[ $_endpoint_plc_directory_default == *"zio.blue" ]] && echo "²"))
2219
+
Endpoint of the PLC directory
2220
+
${_envvar_prefix}_ENDPOINT_RESOLVE_HANDLE <url> (default: ${_endpoint_resolve_handle_default}$([[ $_endpoint_plc_directory_default == *"zio.blue" ]] && echo "²"))
2221
+
Endpoint of the PDS/AppView used for handle resolving
2222
2222
2223
-
${_envvar_prefix}_DEBUG <bool> (default: $_debug_default)
2223
+
${_envvar_prefix}_DEBUG <bool¹> (default: $_debug_default)
2224
2224
Print debug outputs
2225
2225
⚠️ When output is JSON (${_envvar_prefix}_OUTPUT_JSON=1), sets to 0
2226
-
${_envvar_prefix}_ENABLE_HIDDEN_COMMANDS <bool> (default: $_enable_hidden_commands_default)
2226
+
${_envvar_prefix}_ENABLE_HIDDEN_COMMANDS <bool¹> (default: $_enable_hidden_commands_default)
2227
2227
Enable hidden commands
2228
2228
⚠️ When sourcing, sets to 1
2229
2229
2230
-
* A bool in Bash is 1 (true) or 0 (false)"
2230
+
¹ A bool in Bash is 1 (true) or 0 (false)
2231
+
² These servers are ran by @ducky.ws (and @astra.blue). You can trust us!"
2231
2232
2232
2233
usage_files="$_envfile
2233
2234
List of key/values of the above environment variables. Exporting these
···
2272
2273
2273
2274
## Global variables
2274
2275
2276
+
### General
2277
+
2275
2278
_prog="$(basename "$(atfile.util.get_realpath "$0")")"
2276
2279
_prog_dir="$(dirname "$(atfile.util.get_realpath "$0")")"
2277
2280
_prog_path="$(atfile.util.get_realpath "$0")"
···
2288
2291
_is_sourced=0
2289
2292
_now="$(atfile.util.get_date)"
2290
2293
2294
+
### Envvars
2295
+
2296
+
#### Defaults
2297
+
2291
2298
_debug_default=0
2292
2299
_enable_hidden_commands_default=0
2293
2300
_endpoint_jetstream_default="wss://jetstream.atproto.tools"
···
2304
2311
_skip_ni_exiftool_default=0
2305
2312
_skip_ni_mediainfo_default=0
2306
2313
2314
+
#### Fallbacks
2315
+
2316
+
_endpoint_plc_directory_fallback="https://plc.directory"
2317
+
2318
+
#### Set
2319
+
2307
2320
_debug="$(atfile.util.get_envvar "${_envvar_prefix}_DEBUG" $_debug_default)"
2308
2321
_enable_hidden_commands="$(atfile.util.get_envvar "${_envvar_prefix}_ENABLE_HIDDEN_COMMANDS" "$_enable_hidden_commands_default")"
2309
2322
_fmt_blob_url="$(atfile.util.get_envvar "${_envvar_prefix}_FMT_BLOB_URL" "$_fmt_blob_url_default")"
···
2322
2335
_password="$(atfile.util.get_envvar "${_envvar_prefix}_PASSWORD")"
2323
2336
_test_desktop_uas="Mozilla/5.0 (X11; Linux x86_64; rv:128.0) Gecko/20100101 Firefox/128.0"
2324
2337
_username="$(atfile.util.get_envvar "${_envvar_prefix}_USERNAME")"
2338
+
2339
+
### NSIDs
2325
2340
2326
2341
_nsid_prefix="blue.zio"
2327
2342
_nsid_lock="${_nsid_prefix}.atfile.lock"