roughly sorted by chance of encounter

• general:

  • --th-ff-jpg may fix video thumbnails on some FFmpeg versions (macos, some linux)
  • --th-ff-swr may fix audio thumbnails on some FFmpeg versions
  • if the up2k.db (filesystem index) is on a samba-share or network disk, you'll get unpredictable behavior if the share is disconnected for a bit
    • use --hist or the hist volflag (-v [...]:c,hist=/tmp/foo) to place the db and thumbnails on a local disk instead
    • or, if you only want to move the db (and not the thumbnails), then use --dbpath or the dbpath volflag
  • all volumes must exist / be available on startup; up2k (mtp especially) gets funky otherwise
  • probably more, pls let me know

• python 3.4 and older (including 2.7):

  • many rare and exciting edge-cases because python didn't handle EINTR yet
    • downloads from copyparty may suddenly fail, but uploads should be fine

• python 2.7 on Windows:

  • cannot index non-ascii filenames with -e2d
  • cannot handle filenames with mojibake

if you have a new exciting bug to share, see reporting bugs

not my bugs

same order here too

• Chrome issue 1317069 -- if you try to upload a folder which contains symlinks by dragging it into the browser, the symlinked files will not get uploaded

• Chrome issue 1352210 -- plaintext http may be faster at filehashing than https (but also extremely CPU-intensive)

• Chrome issue 383568268 -- filereaders in webworkers can OOM / crash the browser-tab

  • copyparty has a workaround which seems to work well enough

• Firefox issue 1790500 -- entire browser can crash after uploading ~4000 small files

• Android: music playback randomly stops due to battery usage settings

• iPhones: the volume control doesn't work because apple doesn't want it to

  • AudioContext will probably never be a viable workaround as apple introduces new issues faster than they fix current ones

• iPhones: music volume goes on a rollercoaster during song changes

  • nothing I can do about it because AudioContext is still broken in safari

• iPhones: the preload feature (in the media-player-options tab) can cause a tiny audio glitch 20sec before the end of each song, but disabling it may cause worse iOS bugs to appear instead

  • just a hunch, but disabling preloading may cause playback to stop entirely, or possibly mess with bluetooth speakers
  • tried to add a tooltip regarding this but looks like apple broke my tooltips

• iPhones: preloaded awo files make safari log MEDIA_ERR_NETWORK errors as playback starts, but the song plays just fine so eh whatever

  • awo, opus-weba, is apple's new take on opus support, replacing opus-caf which was technically limited to cbr opus

• iPhones: preloading another awo file may cause playback to stop

  • can be somewhat mitigated with mp.au.play() in mp.onpreload but that can hit a race condition in safari that starts playing the same audio object twice in parallel...

• Windows: folders cannot be accessed if the name ends with .

  • python or windows bug

• Windows: msys2-python 3.8.6 occasionally throws RuntimeError: release unlocked lock when leaving a scoped mutex in up2k

  • this is an msys2 bug, the regular windows edition of python is fine

• VirtualBox: sqlite throws Disk I/O Error when running in a VM and the up2k database is in a vboxsf

  • use --hist or the hist volflag (-v [...]:c,hist=/tmp/foo) to place the db and thumbnails inside the vm instead
    • or, if you only want to move the db (and not the thumbnails), then use --dbpath or the dbpath volflag
  • also happens on mergerfs, so put the db elsewhere

• Ubuntu: dragging files from certain folders into firefox or chrome is impossible

  • due to snap security policies -- see snap connections firefox for the allowlist, removable-media permits all of /mnt and /media apparently

breaking changes

upgrade notes

• 1.9.16 (2023-11-04):
  • --stats/prometheus: cpp_bans renamed to cpp_active_bans, and that + cpp_uptime are gauges
• 1.6.0 (2023-01-29):
  • http-api: delete/move is now POST instead of GET
  • everything other than GET and HEAD must pass cors validation
• 1.5.0 (2022-12-03): new chunksize formula for files larger than 128 GiB
  • users: upgrade to the latest cli uploader if you use that
  • devs: update third-party up2k clients (if those even exist)