Cleaning up orphaned images. How do image files and hashes used to load them correlate?

whatwhatwha · August 18, 2025, 5:49pm

For a stash-box instance, how do the image files and the hashes used to reference them in the Stash-Box correlate.

To view an image in stash-box you get one hash, but the corresponding file stored in data/images has a different file name.

Can someone confirm that deleting the scene or the performer does not actually delete the image files associated with that scene or performer. In the past, I believe I determined this was the case. So is there any function that can be used with stash-box to clean up images left behind from deleted scenes and performers?

Scenario: A duplicate perforrmer was submitted and approved. The duplicate performer was deleted but the images associated with the performer still remain in the data/images directory.

Thanks

DogmaDragon · August 30, 2025, 8:53am

There are services that destroy unsued images. Not sure how often they run though.

github.com/stashapp/stash-box

pkg/image/service.go

c5a31be44


      
          // DestroyUnusedImages destroys all images that are not used for a scene,
          // performer or studio.
          func (s *Service) DestroyUnusedImages() error {
          	unused, err := s.Repository.FindUnused()
          	if err != nil {
          		return err
          	}
          
          	cacheManager := GetCacheManager()
          
          	for len(unused) > 0 {
          		for _, i := range unused {
          			err = s.Destroy(models.ImageDestroyInput{
          				ID: i.ID,
          			})
          			if err != nil {
          				return err
          			}
          			// Clear image from cache
          			if cacheManager != nil {

This file has been truncated. show original

github.com/stashapp/stash-box

pkg/image/service.go

c5a31be44


      
          // DestroyUnusedImage destroys the image with the provided ID if it is not used for a scene,
          // performer or studio.
          func (s *Service) DestroyUnusedImage(imageID uuid.UUID) error {
          	unused, err := s.Repository.IsUnused(imageID)
          	if err != nil {
          		return err
          	}
          
          	if unused {
          		err = s.Destroy(models.ImageDestroyInput{
          			ID: imageID,
          		})
          		if err != nil {
          			return err
          		}
          	}
          
          	return nil
          }