We can create them and see them on the file dialogs, but not yet load them back. I want stashed files to remember the original filename. I think that implies the ability to add a note to them. But I don't yet know how to represent the note on disk. And this creates cascading questions, like should editing a stash file continue to modify it or create a new version? How to create a new version? Should unstash copy or move? |
||
|---|---|---|
| assets | ||
| screens | ||
| 0000-freewheeling-start | ||
| 0001-on | ||
| 0002-Debug_animations_in_progress | ||
| 0003-refresh_debug_animations | ||
| 0004-on.update | ||
| 0005-animate | ||
| 0006-loiter | ||
| 0007-save_callstack | ||
| 0008-Debug_animation_period | ||
| 0010-Line_height | ||
| 0011-on.initialize | ||
| 0012-on.draw | ||
| 0013-on.keychord_press | ||
| 0014-on.text_input | ||
| 0015-on.key_release | ||
| 0016-on.mouse_press | ||
| 0017-on.mouse_release | ||
| 0019-Line_number_padding | ||
| 0020-draw_editor_border | ||
| 0021-draw_menu | ||
| 0023-Menu_top | ||
| 0024-Menu_left | ||
| 0025-Menu_height | ||
| 0026-Menu_bottom | ||
| 0027-Menu_background | ||
| 0028-draw_output_border | ||
| 0029-Safe_width | ||
| 0030-Safe_height | ||
| 0031-on.resize | ||
| 0032-update_font_settings | ||
| 0033-Normal_color | ||
| 0034-draw_scrollbar | ||
| 0035-compute_scrollbar | ||
| 0036-adjust_scrollbar | ||
| 0038-on_editor_scrollbar | ||
| 0040-on_editor_scrollbar_area | ||
| 0043-map | ||
| 0045-Current_pane | ||
| 0046-Global_state | ||
| 0047-Current_pane_index | ||
| 0048-Panes | ||
| 0049-new_pane | ||
| 0050-print_to_output | ||
| 0051-run_button | ||
| 0052-enable_loiter | ||
| 0054-Animations_in_progress | ||
| 0056-end_frame | ||
| 0058-draw_next_frames_of_animations | ||
| 0059-previous_pane_button | ||
| 0060-next_pane_button | ||
| 0061-new_pane_button | ||
| 0063-Show_code | ||
| 0066-copy_button | ||
| 0067-paste_button | ||
| 0069-output_editor_state | ||
| 0070-code_editor_state | ||
| 0072-settings_button | ||
| 0076-delete_pane_button | ||
| 0079-White | ||
| 0080-Show_menu | ||
| 0081-draw_settings_menu | ||
| 0082-draw_slider | ||
| 0083-slider | ||
| 0084-update_sliders | ||
| 0085-slider_value | ||
| 0086-mouse_press_consumed_by_any_slider | ||
| 0087-on_slider | ||
| 0090-Background_color | ||
| 0091-Foreground_color | ||
| 0092-Settings_menu_area | ||
| 0093-on_area | ||
| 0097-Font_height | ||
| 0098-on.save_settings | ||
| 0099-on.load_settings | ||
| 0100-car | ||
| 0101-on.mouse_wheel_move | ||
| 0102-send_errors_to_output | ||
| 0104-call_protected | ||
| 0105-clear_handlers | ||
| 0108-Overflow_button | ||
| 0109-overflow_button | ||
| 0110-maybe_draw_overflow_button | ||
| 0111-populate_missing_handlers | ||
| 0114-update_output_editor | ||
| 0115-Title_font | ||
| 0116-save_button | ||
| 0117-load_button | ||
| 0118-overflowable_button | ||
| 0119-draw_file_dialog | ||
| 0120-Show_file_dialog | ||
| 0121-Directory | ||
| 0122-Directory_contents | ||
| 0123-refresh_directory_contents | ||
| 0124-styled_button | ||
| 0125-File_dialog_callback | ||
| 0126-one_time_save | ||
| 0127-one_time_load | ||
| 0128-draw_file_dialog_input | ||
| 0129-draw_cursor | ||
| 0131-keychord_press_on_file_dialog | ||
| 0132-text_input_on_file_dialog | ||
| 0133-File_dialog_input_text | ||
| 0134-reset_file_dialog_state | ||
| 0138-File_dialog_input_start_suffix | ||
| 0140-refresh_file_dialog_input_start | ||
| 0141-File_dialog_input_draw_suffix | ||
| 0142-right_justified_button | ||
| 0143-File_dialog_input_right_margin | ||
| 0144-filenames_from_all_panes | ||
| 0145-Initial_load_filenames | ||
| 0146-load_panes_from_previous_session | ||
| 0147-Highlighted_button_color | ||
| 0148-Active_button | ||
| 0149-Border_color | ||
| 0150-Button_pressed | ||
| 0151-compute_scrollbar_topy | ||
| 0152-Real_print | ||
| 0154-on.mouse_move | ||
| 0155-on.touch_press | ||
| 0156-on.touch_release | ||
| 0157-on.touch_move | ||
| 0158-Font_filename | ||
| 0158-on.quit | ||
| 0159-eval_all | ||
| 0159-run_screen | ||
| 0160-run_app | ||
| 0161-press_run_button | ||
| 0161-stop_app | ||
| 0162-Output_editor_state | ||
| 0162-press_stop_button | ||
| 0163-press_show_button | ||
| 0164-press_hide_button | ||
| 0165-press_save_button | ||
| 0166-press_load_button | ||
| 0167-press_next_pane_button | ||
| 0168-press_previous_pane_button | ||
| 0169-editor_right_margin | ||
| 0171-code_editor_bottom_margin | ||
| 0172-Tooltip_background | ||
| 0173-Tooltip_foreground | ||
| 0174-Is_mobile | ||
| 0175-show_tooltip | ||
| 0176-on.quit | ||
| 0177-has_local_modifications | ||
| 0178-revert_button | ||
| 0179-press_revert_button | ||
| 0180-Local_modifications_color | ||
| 0181-local_modifications_color | ||
| 0182-Stash_color | ||
| 0183-stash_button | ||
| 0184-Stash_directory | ||
| 0185-stash_pane | ||
| 0186-press_stash_button | ||
| 0187-directory_contents | ||
| 0188-add_files_to_dialog | ||
| LICENSE.txt | ||
| Manual_tests.md | ||
| MemoryReferenceInfo.lua.0 | ||
| MemoryReferenceInfo.lua.unused | ||
| README.md | ||
| app.lua | ||
| button.lua | ||
| colorize.lua | ||
| conf.lua | ||
| default_map | ||
| edit.lua | ||
| file.lua | ||
| json.lua | ||
| keychord.lua | ||
| live.lua | ||
| main.lua | ||
| nativefs.lua | ||
| reference.md | ||
| search.lua | ||
| select.lua | ||
| test.lua | ||
| text.lua | ||
| text_tests | ||
| text_tests.lua | ||
| undo.lua | ||
| wav.lua | ||
README.md
A template repo for developing cross-platform apps on mobile devices
Copy this repo to get a leg up creating tiny, low-maintenance, cross-platform apps that you can make changes to right on a phone or tablet.
It comes bundled with a few optional goodies:
- Support for tap-to-pan and pinch-to-zoom gestures over an infinite 2D surface for arbitrary graphics and UI.
- A tiny widget library for quickly creating arbitrary UI elements.
Here's an example of the kinds of things you can add to the global variable
widgets. - A typographic scale for scaling the font size of text in visually pleasing increments.
Tap the 'edit' button and then poke around the 'load' menu to learn more.
This repo is an example of a Freewheeling App, designed above all to be easy to run, easy to modify and easy to share.
Getting started
Install LÖVE. It's just a 5MB download, open-source and extremely well-behaved.
Hacking
You can edit the app and UI right on your device. However, there are some gotchas to be aware of when editing such apps on a phone:
-
If you upgrade LÖVE you lose all your local apps and their saved settings. This includes code changes. It's hard to get code changes out due to mobile restrictions. I can't come up with an alternative to copy-paste. This imposes a strict limit on the number of changes I'm willing to make to a large app on my phone.
-
If you upgrade such apps after making local changes to them, you might see strange errors. Local changes are written to an overlay directory, whereas upgrades modify the app in place. The two locations create lots of opportunity for conflicts to arise.
To mitigate this issue, such apps by default list local changes in the output editor every time they run. That will hopefully act as a reminder. There's also some helpers for deleting local changes in the 'scratch' page.
You can also modify the editing environment itself, or repurpose it for a different app entirely, live as it runs. This requires running it on a computer, but is much more reliable. Download the driver app. Here's an example session showing the driver (left window) editing a different app (right window containing yellow text):
Some reference documentation on how to create your own apps.
If the app being modified by the driver lives in a .love file, your changes will go into the save directory. If it lives in a directory (like this repo), your changes will go straight into the same directory.
Keyboard shortcuts
Within the editor widget:
ctrl+fto find patterns within a filectrl+cto copy,ctrl+xto cut,ctrl+vto pastectrl+zto undo,ctrl+yto redoctrl+=to zoom in,ctrl+-to zoom out,ctrl+0to reset zoomalt+right/alt+leftto jump to the next/previous word, respectively- mouse drag or
shift+ movement to select text,ctrl+ato select all
Exclusively tested so far with a US keyboard layout. If you use a different layout, please let me know if things worked, or if you found anything amiss: http://akkartik.name/contact
Known issues
-
No support yet for Unicode graphemes spanning multiple codepoints.
-
No support yet for right-to-left languages.
-
Undo/redo may be sluggish in editor windows containing large files. Large files may grow sluggish in other ways.
-
If you kill the process, say by force-quitting because things things get sluggish, you can lose data.
-
Can't scroll while selecting text with mouse.
-
Some colors can't be customized yet.
Mirrors and Forks
This repo is a fork of lines.love, an editor for plain text where you can also seamlessly insert line drawings. Its immediate upstream is Lua Carousel, a lightweight cross-platform environment for creating little throwaway scripts on a computer or phone. Updates to it can be downloaded from the following mirrors:
- https://git.sr.ht/~akkartik/template-carousel-mobile
- https://tildegit.org/akkartik/template-carousel-mobile
- https://git.merveilles.town/akkartik/template-carousel-mobile
- https://nest.pijul.com/akkartik/template-carousel-mobile (using the Pijul version control system)
Further forks are encouraged. If you show me your fork, I'll link to it here.