> ## Documentation Index
> Fetch the complete documentation index at: https://rockboxzig.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Browse the filesystem under music_dir



## OpenAPI

````yaml /api-reference/openapi.json get /browse/tree-entries
openapi: 3.1.0
info:
  title: Rockbox HTTP API
  version: 1.0.0
  summary: >-
    HTTP REST API for rockboxd — playback, library, playlists, devices,
    settings.
  description: >-
    Rockbox Daemon exposes its full feature surface over HTTP REST on port 6063
    (configurable via `ROCKBOX_TCP_PORT`). It complements the GraphQL API on
    :6062 and the gRPC API on :6061 — all three speak to the same in-process
    state.


    All handlers are defined in `crates/server/src/handlers/` and registered in
    `crates/server/src/lib.rs:run_http_server()`.
  contact:
    name: Rockbox Daemon
    url: https://github.com/tsirysndr/rockboxd
  license:
    name: GPL-2.0
    url: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
servers:
  - url: http://localhost:6063
    description: Default local rockboxd
security: []
tags:
  - name: Albums
  - name: Artists
  - name: Tracks
  - name: Search
  - name: Browse
  - name: Player
  - name: Playlist (queue)
  - name: Saved playlists
  - name: Smart playlists
  - name: Track stats
  - name: Devices
  - name: Settings
  - name: System
  - name: Bluetooth
paths:
  /browse/tree-entries:
    get:
      tags:
        - Browse
      summary: Browse the filesystem under music_dir
      operationId: getTreeEntries
      parameters:
        - name: q
          in: query
          schema:
            type: string
          description: >-
            Path to list (absolute). Defaults to $ROCKBOX_LIBRARY or
            $HOME/Music.
        - name: show_hidden
          in: query
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
          description: Show dotfiles (default false)
      responses:
        '200':
          description: Directory entries
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TreeEntry'
              example:
                - name: >-
                    /Users/tsirysandratraina/Music/Union Of Sound - Acoustic - A
                    Quiet Night In (Explicit)
                  attr: 16
                  time_write: 1768805953
                  customaction: 0
                - name: /Users/tsirysandratraina/Music/Media.localized
                  attr: 16
                  time_write: 1766757435
                  customaction: 0
                - name: /Users/tsirysandratraina/Music/Cannons - Up All Night EP
                  attr: 16
                  time_write: 1766430051
                  customaction: 0
        '500':
          description: Path is not a directory or other I/O error
components:
  schemas:
    TreeEntry:
      type: object
      properties:
        name:
          type: string
          description: Absolute path
        time_write:
          type: integer
          format: int64
          description: Unix timestamp of last modification
        attr:
          type: integer
          format: int32
          description: 0x10 = directory
        customaction:
          type: integer
          format: int32

````