Django FileBrowser Documentation

Media-Management with Grappelli.

Note

FileBrowser 5.0 requires Django 5.x and Grappelli 4.x.

Installation and Setup

• Quick start guide
  • Requirements
  • Installation
  • Settings
  • Testing
• Settings
  • Main URL/Paths Settings
  • Extensions and Formats
  • Versions
  • Placeholder
  • Extra Settings

API

• API
  • FileListing
    • FileListing
    • Methods
      • listing()
      • walk()
      • files_listing_total()
      • files_walk_total()
      • files_listing_filtered()
      • files_walk_filtered()
      • results_listing_total()
      • results_walk_total()
      • results_listing_filtered()
      • results_walk_filtered()
  • FileObject
    • FileObject
    • Attributes
      • Initial Attributes
      • General Attributes
      • Path and URL attributes
      • Image attributes
      • Folder attributes
      • Version attributes
    • Methods
      • Version methods
      • Delete methods

Fields & Widgets

• Fields & Widgets
  • FileBrowseField
  • Django FileField and the FileBrowser

Admin Interface

• Admin Interface
  • FileBrowser Site
  • Custom Actions
  • File Storages
  • Views
  • Signals

Image Versions

• Versions
  • Defining Versions
  • Custom processors
    • Using the processor
  • Versions and the Admin
  • Versions and the Frontend
    • Templatetag version
  • Versions in Views
  • Placeholder
  • Management Commands

Help

• Help
  • FAQ
  • Troubleshooting
  • Translation
  • FileBrowser 5.0 Release Notes
• Testing
• Changelog

Main Features

• Browse your media files with the admin interface.

• Multiple upload, including a progress bar.

• Automatic thumbnails.

• Image versions to fit your websites grid (esp. useful with adaptive/responsive layouts).

• Integration with TinyMCE.

• FileBrowseField to select images/documents.

• Signals for upload, rename and delete.

• Custom actions.

• Custom file storage engines.

Code

https://github.com/sehmaschine/django-filebrowser

Discussion

Use the FileBrowser Google Group to ask questions or discuss features.

Versions and Compatibility

FileBrowser is always developed against the latest stable Django release.

• FileBrowser 5.0.0 (July 27th, 2026): Compatible with Django 5.0

• FileBrowser 4.0.3 (July 27th, 2023): Compatible with Django 4.0

Current development branches:

• FileBrowser 5.0.1 (Development Version for Django 5.x, see Branch Stable/5.0.x)

• FileBrowser 4.0.4 (Development Version for Django 4.0, see Branch Stable/4.0.x)

Older versions are available at GitHub, but are not supported anymore.