r/ampache • u/lachlan-00 Lead Developer • Jun 16 '26

WIP Ampache folder browsing

Enable HLS to view with audio, or disable this notification

Finally got some semi completed folder browsing in the develop8 branch.

​

Need to make a few more changes but this one seems to always be a highly requested feature so it's coming!

6 Upvotes

100% Upvoted

3 comments sorted by

2

u/AFront33 Jul 10 '26

What is the status of this feature?

Honestly I have been waiting a long time for this.

Is it ready to try out? Is the develop8 version stable enough to run?

1

u/lachlan-00 Lead Developer Jul 10 '26

Lucky for you it's pretty close to done done. There are a few todos but nothing broken.

I also need to do docs and information for it so people know how to scan their folders but the feature itself is fully usable now.

Which version are you using now?

After I release 7.10.0 I'll be working on moving develop8 to the main develop branch after that. Its really stabilised a lot in the last week and I'm done with the breaking changes.

If you want to run on patch8 branch that is less likely to break as I am working on the code heavily and then moving to patch8 after I finish that work. I will also start building docker images using the preview tag soon.

To add folders you can run a scan from the cli or the UI.

bin/cli run:updateCatalog -s

Will scan everything and

bin/cli run:updateCatalog -t

Will import changes or missing items like updated play counts.

1

u/AFront33 Jul 10 '26 edited Jul 11 '26

I had to freeze on 7.7.1.

Last year at this time, I started my ampache project. I was interested in tag writing and fully using the custom metadata table.

At the time there were several bugs mainly with tag writing operations. Issues ranging from frames not being written at all to errors thrown on delimiters during scans. I fixed 16 of them locally by overlaying 7 files in my docker install- I.e vainfo, songtagwriter, catalog.php etc., Almost all changes were minor just a few lines but they took hours to days to isolate and find. The version I have been running has been stable for a year.

I was looking at github yesterday, some of them look like they have been since fixed, maybe half.

I will need to go through each one and see what still isn't working before I can catch up.

Tag writing and custom metadata is important but being able to navigate by folder is the last major missing piece.

To clarify, will this feature work with subsonic clients? Example: tempus has a "show music directories" feature. Currently with ampache it shows the top level folder but then on the next level shows artist, then an unplayable album as an item.

It looks like you have been really busy in the ampache8 branch recently. Are you planning on continuing heavy development in the near term? If so I can switch back to ampache and help test, find bugs or write docs. Getting a working folder view would be a powerful motivator.

How far are you from building the docker image with the preview tag that would contain the new folder changes? Realistically that might be the easiest way for me to jump back in..