rendaw/ptadventure

Explore your polytaxis-tagged files.

polytaxis-adventure is a browser for files indexed by polytaxis-monitor.

Installation

Linux

1. Install Python 3, pip, Qt, and pyqt5 using your distribution's package manager.
2. Run

pip install https://github.com/Rendaw/ptadventure.git

Mac OSX

1. Install homebrew
2. Run

brew install --HEAD rendaw/tap/polytaxis-adventure

Configuration

polytaxis-adventure requires no configuration to browse the index, but configuration may be necessary to use advanced features.

Launching Applications

To launch applications from polytaxis-adventure, you must create a launcher configuration file.

1. Run and close polytaxis-adventure from a terminal
2. The output will contain a line with the expected launchers.json file path.
3. Create and edit launchers.json at the expected path.

launchers.json has the following format:

[
	{
		"name": "launcher name",
		"keys": ["file extension", "*", ...],
		"command": ["executable or script", "argument" or "{all-files}" or {"file"}],
		"unwrap": true,
	},
	...
]

name is the name of the command displayed in the open button/menu.

keys is a list of file extensions or *. The open button/menu shows the launchers that matched the most files in the selection/display. If * is included, the launcher will be displayed for all files.

command is the command to run, plus a template of its arguments. The special argument "{all-files}" in "command" is expanded to all selected files or all displayed files if none are selected. The special argument "{one-file}" in "command" is expanded to one files, and the command is run for each selected file (displayed file, if none are selected) individually.

unwrap indicates whether the paths should be translated to use polytaxis-unwrap. This argument is optional and defaults to true.

An example launchers.json:

[
	{
		"name": "mpv music",
		"keys": [
			".mp3", ".mp3.p",
			".aac", ".aac.p", 
			".ogg", ".ogg.p", 
			".wma", ".wma.p", 
			".mp4", ".mp4.p",
			".m4a", ".m4a.p"
		],
		"command": ["xfce4-terminal", "-x", "mpv", "--no-audio-display", "{all-files}"]
	},
	{
		"name": "collect",
		"keys": ["*"],
		"command": ["cp", "{one-file}", "/home/rendaw/pt-collection"],
		"unwrap": false
	}
]

mpv music will open all files with mpv in a new terminal.

export will copy files to /home/rendaw/pt-collection.

Support

Ask questions and raise issues on the GitHub issue tracker.

See Contributing below for information about prioritizing issues.

Contributing

1. Develop and submit pull requests.

2. Fund development via https://www.bountysource.com/

ptadventure's Issues

Enter to launch default app

Currently enter on a selected item does nothing.

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/24430616-enter-to-launch-default-app?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Query history back and forward, buttons

Be able to go back to the previous version of the current query - for instance, if you changed title=x to title=y (by list selection) you could go back to title=x with the back button.

Typed changes may need to be combined.

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/24430817-query-history-back-and-forward-buttons?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Rearranging elements

Elements should be rearrangeable, either by drag and drop or with some sort of left/right/home/end buttons.

Element history

Each element type has a history, for adding elements with common values. Weighted (last usage, total usage count, etc)?

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/21148157-element-history?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Configure launchers in-app

Currently it requires a manually created config file.

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/21147760-configure-launchers-in-app?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Narrow include/exclude queries by other includes/excludes if present

So media=book author= would only show author= tags present in the current query results.

Optional?

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/21217956-narrow-include-exclude-queries-by-other-includes-excludes-if-present?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Refresh

If the database changes, there should be a way to manually refresh. Just the display area should be sufficient I think.

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/21133694-refresh?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Query history

To look up previous requests easily. May default to last query when started (?) - this may be less useful if you have multiple sessions. Weighted (last usage, total usage count, etc)?

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/21148037-query-history?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Prepare for translation

Wrap strings with gettext/interpolation, probably.

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/21148746-prepare-for-translation?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).

Better icons, logo, theme

Prepared queries via config file

Allow user to create prepared queries as a template for new queries. Similar to query history.

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/21148973-prepared-queries-via-config-file?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F16445198&utm_medium=issues&utm_source=github).