Initial commit

README.md

@@ -0,0 +1,60 @@
+# Miller
+
+![](screenshot.png)
+
+Miller Columns File Manager ("Miller") is a simple cross-platform file manager written in PyQt6 that provides a file management interface based on the [Miller Columns](https://en.wikipedia.org/wiki/Miller_columns) concept.
+
+## Features
+
+- **Column File Navigation**: Navigate through directories using a column-based interface.
+- **Context Menus**: Right-click on files and folders to access context-sensitive actions.
+- **Toolbar**: Quickly navigate to the parent directory, home directory, and view the current directory path.
+- **Platform Support**: Basic support for platform-specific context menus (currently implemented for Windows).
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.x
+- PyQt6
+- pywin32 (for Windows platform integration)
+
+### Installation
+
+1. Clone the repository:
+
+   ```
+   bash
+   git clone https://github.com/yourusername/miller-columns-file-manager.git
+   cd miller-columns-file-manager
+   ``` 
+
+2. Install dependencies:
+
+   ```
+   pip install -r requirements.txt
+   ```
+
+### Usage
+
+```
+python miller.py
+```
+
+* Use the toolbar buttons to navigate (Up, Home) and view the current directory path.
+* Click on folders to navigate deeper into the directory structure.
+* Double-click on folders to open them in Windows Explorer.
+* Right-click on files or folders to access context menu actions.
+
+### Contributing
+
+Contributions are welcome! Please fork the repository and submit a pull request with your improvements.
+
+### License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+### Acknowledgments
+
+- PyQt6 Documentation: https://doc.qt.io/qtforpython-6/
+- Windows platform integation: https://github.com/mhammond/pywin32

miller.py

@@ -0,0 +1,268 @@
+import sys
+import os
+from PyQt6.QtWidgets import (
+    QApplication, QMainWindow, QHBoxLayout, QListView,
+    QWidget, QAbstractItemView, QMenuBar, QMenu, QToolBar,
+    QMessageBox, QLineEdit
+)
+from PyQt6.QtCore import QModelIndex, QSettings, QByteArray, Qt, QDir
+from PyQt6.QtGui import QFileSystemModel, QIcon, QAction
+
+if os.name == 'nt':
+    import windowsproperties
+    import windowscontextmenu
+
+class MillerColumns(QMainWindow):
+    def __init__(self):
+        super().__init__()
+        self.setWindowTitle("Miller Columns File Manager")
+        self.resize(800, 600)  # Default size
+
+        self.central_widget = QWidget()
+        self.setCentralWidget(self.central_widget)
+
+        self.layout = QHBoxLayout(self.central_widget)
+
+        self.columns = []
+        self.file_model = QFileSystemModel()
+        self.file_model.setRootPath('')
+        self.file_model.setOption(QFileSystemModel.Option.DontUseCustomDirectoryIcons, False)  # Enable color icons
+
+        home_dir = os.path.expanduser('~')
+        self.add_column(self.file_model.index(home_dir))
+
+        self.create_menus()
+        self.create_toolbar()
+        self.read_settings()
+
+    def show_context_menu(self, pos, column_view):
+        index = column_view.indexAt(pos)
+        if index.isValid():
+            file_path = self.file_model.filePath(index)
+            is_directory = self.file_model.isDir(index)
+
+            if os.name == 'nt':
+                self.show_windows_context_menu(file_path)
+                return
+
+            context_menu = QMenu()
+
+            open_action = context_menu.addAction("Open")
+            open_action.triggered.connect(lambda: self.on_double_clicked(index))
+            context_menu.addSeparator()
+
+            context_menu.addAction(self.cut_action)
+            context_menu.addAction(self.copy_action)
+            context_menu.addAction(self.paste_action)
+            context_menu.addSeparator()
+
+            context_menu.addAction(self.move_to_trash_action)
+            context_menu.addAction(self.delete_action)
+            context_menu.addSeparator()
+
+            properties_action = context_menu.addAction("Properties")
+            properties_action.triggered.connect(lambda: self.show_properties(index))
+
+            if os.name == 'nt':
+                context_menu.addSeparator()
+                show_windows_context_menu = context_menu.addAction("Show Windows Context Menu")
+                show_windows_context_menu.triggered.connect(lambda: self.show_windows_context_menu(file_path))
+                context_menu.addAction(show_windows_context_menu)
+
+            context_menu.exec(column_view.viewport().mapToGlobal(pos))
+
+    def show_windows_context_menu(self, file_path):
+        try:
+            windowscontextmenu.show_context_menu(file_path)
+        except Exception as e:
+            QMessageBox.critical(self, "Error", f"{e}")
+
+    def show_properties(self, index: QModelIndex):
+        print("Show properties")
+        if index.isValid():
+            file_path = self.file_model.filePath(index)
+            print(file_path)
+            if os.name == 'nt':
+                windowsproperties.get_file_properties(file_path)
+            else:
+                print("show_properties not implemented for this platform")
+
+    def create_menus(self):
+        # Create a menubar
+        menubar = self.menuBar()
+
+        # File menu
+        file_menu = menubar.addMenu("File")
+        close_action = QAction("Close", self)
+        close_action.triggered.connect(self.close)
+        quit_action = QAction("Quit", self)
+        quit_action.triggered.connect(QApplication.instance().quit)
+        file_menu.addAction(close_action)
+        file_menu.addSeparator()
+        file_menu.addAction(quit_action)
+
+        # Edit menu
+        edit_menu = menubar.addMenu("Edit")
+        self.undo_action = QAction("Undo", self)
+        self.undo_action.setEnabled(False)
+        self.cut_action = QAction("Cut", self)
+        self.cut_action.setEnabled(False)
+        self.copy_action = QAction("Copy", self)
+        self.copy_action.setEnabled(False)
+        self.paste_action = QAction("Paste", self)
+        self.paste_action.setEnabled(False)
+        self.move_to_trash_action = QAction("Move to Trash", self)
+        self.move_to_trash_action.setEnabled(False)
+        self.delete_action = QAction("Delete", self)
+        self.delete_action.setEnabled(False)
+        self.empty_trash_action = QAction("Empty Trash", self)
+        self.empty_trash_action.setEnabled(False)
+        self.empty_trash_action.triggered.connect(self.empty_trash)
+
+        edit_menu.addAction(self.undo_action)
+        edit_menu.addSeparator()
+        edit_menu.addAction(self.cut_action)
+        edit_menu.addAction(self.copy_action)
+        edit_menu.addAction(self.paste_action)
+        edit_menu.addSeparator()
+        edit_menu.addAction(self.move_to_trash_action)
+        edit_menu.addAction(self.delete_action)
+        edit_menu.addSeparator()
+        edit_menu.addAction(self.empty_trash_action)
+
+        # Help menu
+        help_menu = menubar.addMenu("Help")
+        about_action = QAction("About", self)
+        about_action.triggered.connect(self.show_about)
+        help_menu.addAction(about_action)
+
+    def move_to_trash(self, indexes):
+        print("Move to trash")
+
+    def delete(self, indexes):
+        print("Delete")
+
+    def empty_trash(self):
+        print("Empty trash")
+
+    def create_toolbar(self):
+        # Create a toolbar
+        toolbar = QToolBar("Navigation")
+        self.addToolBar(Qt.ToolBarArea.TopToolBarArea, toolbar)
+
+        up_action = QAction(QIcon.fromTheme("go-up"), "Up", self)
+        up_action.triggered.connect(self.go_up)
+        toolbar.addAction(up_action)
+
+        home_action = QAction(QIcon.fromTheme("home"), "Home", self)
+        home_action.triggered.connect(self.go_home)
+        toolbar.addAction(home_action)
+
+        # Add a QLineEdit to show current directory path
+        self.path_label = QLineEdit()
+        self.path_label.setReadOnly(True)  # Make it read-only
+        self.path_label.setPlaceholderText("Current Directory Path")
+        toolbar.addWidget(self.path_label)
+
+    def show_about(self):
+        QMessageBox.about(self, "About", "Miller Columns File Manager\nVersion 1.0")
+
+    def _update_view(self, parent_index):
+        if parent_index.isValid():
+            for column_view in self.columns[1:]:
+                self.layout.removeWidget(column_view)
+                column_view.deleteLater()
+            self.columns = self.columns[:1]
+            self.columns[0].setRootIndex(parent_index)
+
+            # Update current directory path
+            self.path_label.setText(self.file_model.filePath(parent_index))
+
+    def go_up(self):
+        if self.columns:
+            first_view = self.columns[0]
+            current_index = first_view.rootIndex()
+            if current_index.isValid():
+                parent_index = current_index.parent()
+                self._update_view(parent_index)
+
+    def go_home(self):
+        if self.columns:
+            first_view = self.columns[0]
+            current_index = first_view.rootIndex()
+            if current_index.isValid():
+                home_dir = os.path.expanduser('~')
+                parent_index = self.file_model.index(home_dir)
+                self._update_view(parent_index)
+
+    def add_column(self, parent_index=None):
+        column_view = QListView()
+        column_view.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
+        column_view.setUniformItemSizes(True)
+        column_view.setAlternatingRowColors(True)  # Enable alternating row colors
+        column_view.setModel(self.file_model)
+
+        if parent_index:
+            column_view.setRootIndex(parent_index)
+
+        self.layout.addWidget(column_view)
+        self.columns.append(column_view)
+
+        column_view.selectionModel().currentChanged.connect(self.on_selection_changed)
+        column_view.doubleClicked.connect(self.on_double_clicked)
+
+        # Ensure context menu policy is set
+        column_view.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu)
+
+        # Connect the custom context menu
+        column_view.customContextMenuRequested.connect(lambda pos: self.show_context_menu(pos, column_view))
+
+        # Allow dragging
+        column_view.setDragEnabled(True)
+
+    def on_selection_changed(self, current: QModelIndex, previous: QModelIndex):
+        column_index = self.get_column_index(current)
+        if column_index is not None:
+            # Remove all columns to the right of the current column
+            while len(self.columns) > column_index + 1:
+                column_to_remove = self.columns.pop()
+                self.layout.removeWidget(column_to_remove)
+                column_to_remove.deleteLater()
+
+            # Add a new column if the selected item is a directory
+            if self.file_model.isDir(current):
+                self.add_column(current)
+
+            # Update current directory path
+            self.path_label.setText(self.file_model.filePath(current))
+
+    def on_double_clicked(self, index: QModelIndex):
+        # if not self.file_model.isDir(index):
+        file_path = self.file_model.filePath(index)
+        os.startfile(file_path)
+
+    def get_column_index(self, index: QModelIndex):
+        for i, column in enumerate(self.columns):
+            if column.selectionModel() == self.sender():
+                return i
+        return None
+
+    def closeEvent(self, event):
+        self.write_settings()
+        super().closeEvent(event)
+
+    def read_settings(self):
+        settings = QSettings("MyCompany", "MillerColumnsFileManager")
+        geometry = settings.value("geometry", QByteArray())
+        if geometry:
+            self.restoreGeometry(geometry)
+
+    def write_settings(self):
+        settings = QSettings("MyCompany", "MillerColumnsFileManager")
+        settings.setValue("geometry", self.saveGeometry())
+
+if __name__ == '__main__':
+    app = QApplication(sys.argv)
+    window = MillerColumns()
+    window.show()
+    sys.exit(app.exec())

requirements.txt

@@ -0,0 +1,2 @@
+PyQt6==6.7.0
+pywin32==306